Retrieve requested token balances on Solana or Robinhood using wallet and token_addresses. Robinhood uses the same unavailable-valuation semantics as V1 token balance: value and valuation_price are null when required valuation evidence is absent; price is null only when the spot quote is absent. Proven zero values remain zero. Raw balance and decimals are retained. Existing V2 field names and string encoding for known value are unchanged. Missing holdings may be null entries; when no requested holding exists data may be null. NFT token-ID request entries are not supported by this release.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Batch token-balance lookup for one Solana wallet.
- Maximum request size is
500token addresses. - Response is ordered by the submitted token list and returns one balance snapshot per requested token.
ui_amount_mode=scaledapplies Solana Token-2022 scaled UI amount when the token supports the scaled UI extension.
Reading the numbers. balance is the raw balance in base units. amount is the decimal-adjusted balance, or scaled UI amount when requested and supported. price is the latest token price in USD, and value is the wallet holding value in USD.
- Lite
- Starter
- Premium
- Business
- Enterprise
Solana
Compute Unit ⚙️
- Batch CU is calculated as
ceil(10 * token_count^0.8).- With the maximum
500tokens per request
- With the maximum
Use Cases 💡
- Load many token balances for one wallet in one request.
- Power portfolio pages, treasury views, and token-watch grids.
- Join wallet balances with prices for fast position-value displays.
How to Use 🛠️
- Set
x-chain=solana.- Send the wallet address and up to
50token mints in the POST body. - Use
ui_amount_mode=rawfor raw-decimal output orui_amount_mode=scaledfor Token-2022 scaled UI amounts when supported.
- Send the wallet address and up to
Best Practices ✅
- Deduplicate token mints before sending the batch.
- Use this batch endpoint for known token sets; use broader wallet portfolio endpoints when discovery matters more than exact token selection.
- Reuse one batch response across multiple UI components during the same refresh cycle.
Limitations ⚠️
- Solana only.
- Maximum
50tokens per request.
- Maximum