Token Balance API

Query token balance information for any Solana wallet address and token combination, including SPL tokens and native SOL.

POST/balance/api/v1/sol/balance

Request Parameters

Parameter	Type	Required	Description
wallet	string	Yes	Solana wallet address
token	string	Yes	Token mint address

Supported Tokens

Query balance for any token on Solana:

• Native SOL - Use pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn
• SPL Tokens - Any SPL token mint address
• Popular Tokens - USDC, USDT, RAY, SRM, and more
• Custom Tokens - Any valid token contract address

Response Format

{
  "wallet": "FZ1t8TZtx7VSCQdBsxvFJiezj9paUBF6Ub7RKA2eTGyE",
  "token": "pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn",
  "balance": "1250000000",
  "decimals": 9,
  "uiAmount": 1.25,
  "symbol": "SOL",
  "timestamp": "2024-01-20T10:30:00Z"
}

Response Fields

• balance - Raw token amount (smallest unit)
• decimals - Token decimal places
• uiAmount - Human-readable amount (balance / 10^decimals)
• symbol - Token symbol if available

Responses

200

Balance retrieved successfully

{
  "wallet": "FZ1t8TZtx7VSCQdBsxvFJiezj9paUBF6Ub7RKA2eTGyE",
  "token": "pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn",
  "balance": "1250000000",
  "decimals": 9,
  "uiAmount": 1.25,
  "symbol": "SOL",
  "timestamp": "2024-01-20T10:30:00Z"
}

400

Bad Request - Invalid wallet or token address

{
  "error": "Invalid wallet address format",
  "timestamp": "2024-01-20T10:30:00Z"
}

401

Unauthorized - Invalid API key

{
  "error": "Invalid or missing API key",
  "timestamp": "2024-01-20T10:30:00Z"
}

404

Token account not found

{
  "error": "Token account not found for the specified wallet and token",
  "timestamp": "2024-01-20T10:30:00Z"
}

500

Internal Server Error

{
  "error": "Failed to retrieve balance data",
  "timestamp": "2024-01-20T10:30:00Z"
}