Skip to main content
Get token account information for Solana wallets with Launchpad Trade API
POST/utilities/token-info
Retrieve token account details for one or multiple wallets in a single call. Filter results by specific mints or balance status.

​
Quick Start

curl -X POST https://api.launchpad.trade/utilities/token-info \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "publicKeys": ["7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU"]
  }'

​
Parameters

ParameterTypeDescription
publicKeysstring[]Public keys of the wallets to query. Min 1, max 50
mintsstring[](Optional) Filter results to specific token mint addresses. Only token accounts matching these mints are returned
filterstring(Optional) Filter token accounts by balance status. Default: ALL
FilterDescription
ALLAll token accounts
EMPTYOnly accounts with zero balance
WITH_BALANCEOnly accounts with balance > 0

​
Use Cases

List all tokens held by your wallets — useful for checking positions after a buy or verifying holdings across multiple wallets.
{
  "publicKeys": ["wallet1...", "wallet2..."],
  "filter": "WITH_BALANCE"
}
Use filter: "EMPTY" before calling Close Accounts to estimate how much rent SOL you can reclaim.

​
Response

{
  "success": true,
  "data": {
    "wallets": [
      {
        "wallet": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
        "tokens": [
          {
            "ata": "ATA_ADDRESS...",
            "mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
            "symbol": "USDC",
            "balance": 1000000,
            "balanceFormatted": "1.0",
            "decimals": 6,
            "program": "SPL_TOKEN"
          },
          {
            "ata": "ATA_ADDRESS_2...",
            "mint": "So11111111111111111111111111111111111111112",
            "symbol": "SOL",
            "balance": 500000000,
            "balanceFormatted": "0.5",
            "decimals": 9,
            "program": "SPL_TOKEN"
          }
        ],
        "stats": {
          "total": 5,
          "withBalance": 3,
          "empty": 2,
          "splToken": 4,
          "token2022": 1
        }
      }
    ],
    "totals": {
      "wallets": 1,
      "tokens": 5,
      "withBalance": 3,
      "empty": 2
    }
  }
}

​
Errors

{
  "success": false,
  "error": {
    "code": "INVALID_WALLET",
    "message": "Invalid public key: 7xKX..."
  }
}
CodeMessageCause
INVALID_WALLETInvalid public keyOne of the wallet addresses is invalid
INVALID_MINTInvalid mint addressOne of the mint addresses is invalid
INVALID_FILTERInvalid filterFilter is not ALL, EMPTY, or WITH_BALANCE
NO_WALLETSNo wallets providedNo public keys provided
TOO_MANY_WALLETSMaximum 50 wallets per requestMore than 50 wallets submitted
RATE_LIMITRate limit exceededToo many requests — see Rate Limits
INTERNAL_ERRORInternal server errorRetry or contact support

​
Notes

  • This is a read-only endpoint — no transactions are sent and no fees are charged
  • Both SPL Token and Token 2022 accounts are included in the response

​
What’s Next?

Close Accounts

Close empty token accounts and reclaim rent SOL

Check Balance

Check SOL balance for your wallets

Burn Tokens

Burn unwanted tokens from your wallets

Sell Tokens

Exit token positions from your wallets