Overview
Query the token balance list for an address across multiple or specific blockchain networks. This balance lookup supports:
- Native coins (e.g., ETH, BTC)
- EVM-chain ERC20 tokens
- Bitcoin-chain assets (BRC-20, ARC-20, Runes, SRC-20)
- Fractal Bitcoin-chain BRC-20 tokens
Includes optional filtering of risky airdrop tokens.
API Endpoint
GET https://web3.okx.com/api/v5/wallet/asset/all-token-balances-by-address
Request Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
address | String | Yes | Target wallet address |
chains | String | Yes | Comma-separated chain identifiers (max 50 chains) |
filter | String | No | 0: Exclude risky airdrops (default) 1: Include all tokens |
Response Parameters
| Field | Type | Description |
|---|---|---|
tokenAssets | Array | List of token balances |
chainIndex | String | Unique chain identifier |
tokenAddress | String | Smart contract address |
symbol | String | Token ticker (e.g., ETH) |
balance | String | Formatted token quantity |
rawBalance | String | Raw token amount (unsupported chains return empty) |
tokenPrice | String | USD value per token unit |
tokenType | String | 1: Standard token 2: Inscription (e.g., BRC-20) |
transferAmount | String | Directly transferable inscription balance (e.g., BRC-20) |
availableAmount | String | Pending inscription balance requiring engraving |
isRiskToken | Boolean | true: Flagged as risky airdrop |
Use Cases
- Portfolio Tracking: Monitor cross-chain holdings in a single query.
- Risk Management: Filter suspicious airdrops before interactions.
- Dapp Integration: Fetch real-time balances for wallet dashboards.
FAQ
Q: How often is balance data updated?
A: Balances reflect real-time on-chain state with sub-minute latency.
Q: Which chains support rawBalance?
A: Ethereum, Bitcoin, and BSC currently; others will be added progressively.
Q: Can I query NFTs with this endpoint?
A: No—this endpoint focuses solely on fungible tokens and inscriptions.
Q: Why filter risky airdrops?
A: Prevents accidental interaction with scam tokens that may compromise wallet security.
Best Practices
- For high-frequency queries, implement client-side caching.
- Combine with
/wallet/risk-token-listto customize risk filters. - Use pagination when processing large token sets (>100 entries).
Need deeper technical guidance? 👉 Contact our API team