Total Token Balances: Asset Query by Address

Retrieve comprehensive token balance information for any blockchain address across multiple chains. This powerful API supports:

Native chain tokens
EVM-based ERC20 tokens
Bitcoin ecosystem assets (BRC-20, ARC-20, Runes, SRC-20)
Fractal Bitcoin chain tokens (FBRC-20)

👉 Explore our Web3 API solutions for advanced blockchain data access.

API Endpoint

GET https://web3.okx.com/api/v5/wallet/asset/all-token-balances-by-address

Supported Token Types

Token Category	Examples
Native Tokens	ETH, BNB, MATIC
EVM Tokens	ERC20, BEP20, HRC20
Bitcoin Inscriptions	BRC-20, SRC-20
Alternative Chains	Fractal Bitcoin (FBRC-20)

Request Parameters

Required Fields:

address: Target wallet address (String)
chains: Array of chain identifiers (Max 50 chains)

Optional Filters:

filter=0: Exclude risky airdrop tokens (default)
filter=1: Include all tokens

Response Structure

{
  "tokenAssets": [
    {
      "chainIndex": "chain_identifier",
      "tokenAddress": "contract_address",
      "symbol": "TOKEN",
      "balance": "100.50",
      "tokenType": "1|2",
      "isRiskToken": false
    }
  ]
}

Key Response Fields:

transferAmount: Ready-to-use inscription assets
availableAmount: Pending inscription balance
tokenPrice: USD valuation per token unit

Use Cases

Multi-chain Portfolio Tracking
Monitor assets across Ethereum, Bitcoin, and 48+ other chains simultaneously.
Risk Management
Identify and filter suspicious airdrop tokens automatically.
DeFi Integration
Build dashboards displaying native + token balances in unified interfaces.

FAQ

Q: What's the maximum chain limit per request?
A: 50 chains for optimal performance.

Q: How often is balance data updated?
A: Real-time synchronization with blockchain nodes.

Q: Does this support Solana tokens?
A: Currently focuses on EVM and Bitcoin ecosystems.

Q: Can I retrieve historical balance data?
A: This endpoint provides current balances only.

👉 Get API documentation for implementation examples and response samples.