In today’s fast-evolving Web3 ecosystem, managing digital assets across multiple blockchains has become both essential and complex. Whether you're building a decentralized application (dApp), offering wallet services, or analyzing user portfolios, accessing accurate, real-time token balances is critical. The Wallet Asset Balance API enables developers to efficiently retrieve comprehensive asset details for a wallet account across various chains — all through a single, streamlined endpoint.
This guide dives deep into the functionality, parameters, and use cases of the wallet-all-token-balances API, helping you integrate robust asset querying capabilities into your Web3 applications.
What Is the Wallet Asset Balance API?
The Wallet Asset Balance API allows developers to fetch a complete list of token balances held by a specific wallet account across multiple blockchains. It supports a wide range of asset types, including:
- Native coins (e.g., ETH, BTC, OKT)
- EVM-compatible ERC20 tokens
- Bitcoin-ecosystem tokens: BRC-20, ARC-20, Runes, and SRC-20
- Fractal Bitcoin chain BRC-20 tokens
Additionally, this API includes an intelligent filter to exclude risk-associated airdrop tokens, ensuring cleaner and more reliable data for financial analysis or user-facing displays.
👉 Discover how easy it is to integrate real-time asset tracking into your dApp.
Key Features at a Glance
✅ Multi-Chain Support
Query token holdings across numerous blockchains with one request. No need to call separate endpoints for Ethereum, Bitcoin layers, or EVM-compatible networks.
✅ Comprehensive Token Coverage
Supports both traditional fungible tokens and emerging token standards on Bitcoin-based chains — crucial for projects engaging with Ordinals and inscription ecosystems.
✅ Risk Token Filtering
Automatically filter out potentially risky or spammy airdrop tokens using the built-in filter parameter, enhancing data quality and user trust.
✅ Real-Time Data Delivery
Returns up-to-date balance information with millisecond-level timestamp precision via Unix timestamps.
API Endpoint
HTTP Method: GET
Endpoint URL:
https://web3.okx.com/api/v5/wallet/asset/wallet-all-token-balancesThis RESTful endpoint is designed for high availability and low latency, making it ideal for integration into live dashboards, portfolio trackers, and on-chain analytics tools.
Request Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
accountId | String | Yes | Unique identifier for the wallet account. |
chains | String | No | Specify one or more chains to query (e.g., eth,bsc,btc). Separate multiple chains with commas. Maximum of 50 chains per request. |
filter | String | No | Controls whether risk airdrop tokens are filtered:0: Filter out risk tokens (default)1: Include all tokens, regardless of risk status |
💡 Tip: Omitting the chains parameter will return asset data from all supported chains linked to the account.Response Structure
The API returns a JSON object containing an array of token assets and a timestamp indicating when the data was fetched.
Top-Level Fields
tokenAssets: Array of token balance recordstimeStamp: Data retrieval time in Unix milliseconds
Token Asset Object
Each item in tokenAssets contains the following fields:
| Field | Type | Description |
|---|---|---|
chainIndex | String | Unique identifier for the blockchain (e.g., eth, btc) |
tokenAddress | String | Smart contract address; empty for native coins |
address | String | Wallet address being queried |
symbol | String | Token symbol (e.g., USDT, BTC, ordi) |
balance | String | Formatted token balance (human-readable) |
rawBalance | String | Raw balance in base units (e.g., wei/satoshi); may be empty for unsupported chains |
tokenPrice | String | Current market price in USD |
tokenType | String | Type of asset:1: Fungible token2: Inscription (e.g., BRC-20) |
isRiskToken | Boolean | Indicates if the token is flagged as high-risk |
Use Cases and Practical Applications
📊 Portfolio Aggregation Tools
Build cross-chain portfolio dashboards that display total asset value, allocation breakdowns, and price performance — all powered by real-time balance data.
🔍 On-Chain Analytics Platforms
Enhance your research or compliance tools by identifying unusual token holdings, detecting potential scam tokens via isRiskToken, and monitoring user behavior across ecosystems.
💬 Wallet Interfaces
Enable non-custodial wallets to show users their full asset picture without relying on third-party indexers or slow scanning processes.
🛠️ dApp Onboarding & KYC Flows
Verify user eligibility for airdrops, staking pools, or NFT mints by checking specific token balances across chains.
👉 See how top Web3 platforms streamline asset discovery with powerful APIs.
Frequently Asked Questions (FAQ)
Q: Which blockchains are currently supported?
A: The API supports major EVM chains (like Ethereum, BSC, Arbitrum), Bitcoin mainnet (for BRC-20, Runes, etc.), and Fractal Bitcoin. More chains are being added regularly.
Q: How often is the balance data updated?
A: Balances are fetched in real time upon each API call. There is no caching layer, ensuring you receive the latest on-chain state.
Q: Can I query only native coin balances?
A: Yes — simply parse the response for entries where tokenAddress is empty or tokenType is 1, depending on your logic.
Q: What defines a "risk airdrop token"?
A: Risk tokens typically include low-liquidity, unnamed, or maliciously distributed tokens often associated with spam campaigns or phishing attempts. The system uses behavioral and market signals to flag them.
Q: Is there a rate limit for this API?
A: Rate limits depend on your service tier and authentication method. Refer to OKX Web3 API documentation for detailed quotas and best practices.
Q: Can I get historical balance data?
A: This endpoint provides current balances only. For historical tracking, you must store snapshots externally using scheduled calls.
Sample Request & Response
While raw code examples aren’t included here, typical usage involves sending an authenticated GET request with query parameters like:
GET /api/v5/wallet/asset/wallet-all-token-balances?accountId=abc123&chains=eth,btc&filter=0The response returns structured JSON suitable for parsing in any modern programming environment (Node.js, Python, Rust, etc.).
Why Choose This API for Web3 Development?
With increasing fragmentation across Layer 1s and Layer 2s, developers need unified access points to simplify blockchain interactions. The Wallet Asset Balance API delivers:
- Simplified integration: One endpoint replaces dozens of chain-specific calls.
- Enhanced security: Built-in filtering reduces exposure to scam tokens.
- Scalable design: Handles multi-chain queries efficiently, even for power users with diverse portfolios.
Whether you’re developing a DeFi platform or launching a multi-chain wallet, this tool reduces development overhead while improving data accuracy.
👉 Start integrating seamless multi-chain balance checks today.
Final Thoughts
As Web3 adoption grows, so does the demand for efficient, secure, and intelligent data access. The Wallet Asset Balance API empowers developers to offer richer user experiences — from clean portfolio views to advanced risk detection — without compromising performance or reliability.
By leveraging this API, you future-proof your applications against the expanding complexity of blockchain ecosystems while delivering value-driven features that users truly need.
Core Keywords: Wallet Asset Balance API, multi-chain token balance, Web3 wallet integration, ERC20 balance check, BRC-20 token support, Bitcoin inscription API, risk airdrop filtering, real-time balance query