GET /wallet/:address/assets

Discover all burnable items in a wallet. Returns token accounts, NFTs, compressed tokens, and empty accounts along with the actions available for each.

Request


GET https://api.aerosol.com/api/v1/burner/wallet/:address/assets

Headers

Header	Required	Description
`X-Api-Key` or `Authorization`	Yes	API key or session token with `wallet:read` scope

Path parameters

Parameter	Type	Description
`address`	`string`	Solana wallet address

Example request


curl https://api.aerosol.com/api/v1/burner/wallet/DRpbCBMxVnDK7maPM5tGv6MvB3v1sRMC86PZ8okm21hy/assets \
  -H "Authorization: Bearer eyJhbGci..."

Response

200 OK


{
  "walletAddress": "DRpbCBMxVnDK7maPM5tGv6MvB3v1sRMC86PZ8okm21hy",
  "items": [
    {
      "type": "empty_account",
      "address": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
      "mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
      "name": "USD Coin",
      "symbol": "USDC",
      "lamports": 2039280,
      "tokenProgram": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA",
      "isFrozen": false,
      "actions": ["close"]
    },
    {
      "type": "token",
      "address": "4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU",
      "name": "Bonk",
      "symbol": "BONK",
      "imageUri": "https://arweave.net/...",
      "decimals": 5,
      "balance": "100000000",
      "uiBalance": 1000,
      "usdValue": 0.001,
      "tokenProgram": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA",
      "isFrozen": false,
      "actions": ["burn"]
    },
    {
      "type": "nft",
      "address": "9xQeWvG816bUx9EPjHmaT23yvVM2ZWbrrpZb9PusVFin",
      "name": "Degen Ape #4291",
      "imageUri": "https://arweave.net/...",
      "collection": {
        "address": "DSwfRF1jhhu6HpSuzaig1G19kzP73PfLZBPRoge1Sej",
        "name": "Degenerate Ape Academy"
      },
      "tokenProgram": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA",
      "isFrozen": false,
      "actions": ["burn"]
    }
  ],
  "counts": {
    "empty_account": 12,
    "token": 3,
    "nft": 1,
    "fungible_asset": 0,
    "zk_compressed_token": 0,
    "cnft": 0
  }
}

Response fields

Field	Type	Description
`walletAddress`	`string`	The queried wallet address
`items`	`WalletItem[]`	Array of burnable items (see BurnerClient Reference for the full `WalletItem` type)
`counts`	`Record<WalletItemType, number>`	Count of items by type

Error responses

Status	Cause
401	Invalid credentials or session lacks `wallet:read` scope
429	Rate limit exceeded

SDK example


const { items, counts } = await client.getWalletAssets(
  'DRpbCBMxVnDK7maPM5tGv6MvB3v1sRMC86PZ8okm21hy'
)

Raw fetch example


const res = await fetch(
  'https://api.aerosol.com/api/v1/burner/wallet/DRpbCBMxVnDK7maPM5tGv6MvB3v1sRMC86PZ8okm21hy/assets',
  {
    headers: {
      Authorization: `Bearer ${sessionToken}`,
    },
  }
)
const data = await res.json()