Skip to main content
Check wallet balances with Launchpad Trade API
POST/wallets/balance
Retrieve SOL balances — and optionally SPL token balances — for multiple wallets at once.
Only public keys are needed. This endpoint never requires private keys.

​
Quick Start

curl -X POST https://api.launchpad.trade/wallets/balance \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "publicKeys": [
      "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
      "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM",
      "3Hk9rPqM2nL5vYz7xKmNpQrS8tUvWxYz1aBcDeFgHiJk"
    ]
  }'

​
Parameters

ParameterTypeDescription
publicKeysstring[]Array of wallet public keys to query. Between 1 and 100 addresses
tokenAddressstring(Optional) Solana address of an SPL token. When provided, each wallet’s token balance is included alongside SOL

​
Two Query Modes

You can check SOL balances alone, or include a token address to get both SOL and token balances in the same request.
Pass an array of wallet addresses. The response includes the SOL balance for each wallet and a total across all wallets.
{
  "publicKeys": ["7xKX...", "9WzD...", "3Hk9..."]
}
Non-existent or empty wallets return sol: 0 — no error is thrown.

​
Response

{
  "success": true,
  "data": {
    "balances": [
      {
        "wallet": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
        "sol": 1.5
      },
      {
        "wallet": "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM",
        "sol": 0.25
      },
      {
        "wallet": "3Hk9rPqM2nL5vYz7xKmNpQrS8tUvWxYz1aBcDeFgHiJk",
        "sol": 0.0
      }
    ],
    "totalSol": 1.75
  }
}

​
Errors

{
  "success": false,
  "error": {
    "code": "INVALID_WALLET",
    "message": "Invalid wallet address: xyz..."
  }
}
CodeMessageCause
NO_WALLETSNo wallets providedpublicKeys array is empty or missing
INVALID_WALLETInvalid wallet addressOne or more public keys are invalid
INVALID_TOKENInvalid token addresstokenAddress is not a valid Solana address
TOO_MANY_WALLETSMaximum 100 wallets per requestArray exceeds 100 entries
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
  • Non-existent or empty wallets return sol: 0 with no error
  • Token amounts are returned in raw units — divide by 10^decimals to get the human-readable value

​
What’s Next?

Create Wallets

Generate new Solana wallets in bulk

Initialize Wallets

Prepare wallets for optimal trading speed

Distribute SOL

Fund your wallets with SOL

Withdraw SOL

Collect SOL from multiple wallets