-
bitcoin $61769.147764 USD
-2.81% -
ethereum $1743.384989 USD
-3.33% -
tether $0.999069 USD
0.02% -
bnb $571.804060 USD
-2.80% -
usd-coin $0.999854 USD
0.00% -
xrp $0.966271 USD
-1.46% -
solana $72.584973 USD
-3.00% -
tron $0.309764 USD
-0.92% -
hyperliquid $65.747085 USD
-3.44% -
zcash $851.603224 USD
-9.10% -
dogecoin $0.057499 USD
-3.10% -
monero $477.774191 USD
-4.85% -
unus-sed-leo $9.211262 USD
-1.40% -
chainlink $8.864427 USD
-3.12% -
cardano $0.149815 USD
-2.47%
How to Check Token Balance by Wallet Address?
Users can query native and token balances across 7 chains via `/balance/{chain}/{address}`—requiring a valid `X-API-Key`, returning precise stringified values and ENS support.
Sep 15, 2026 at 02:00 pm
Direct Chain-Specific Balance Queries
1. Users can retrieve token balances by submitting a GET request to /balance/{chain}/{address}, where {chain} is one of the seven supported blockchains and {address} is the wallet’s hexadecimal string.
2. The endpoint returns native token balance and ERC-20/BEP-20/SPL token holdings, depending on chain-specific contract standards and indexer coverage.
3. Solana responses include SPL token accounts mapped to the wallet, while Ethereum and Base return both ETH and token balances via multicall aggregation.
4. Hedera queries return only native HBAR balance; HTS tokens require separate contract interaction not covered by this endpoint.
5. Bitcoin responses reflect UTXO-based BTC balance without support for RGB or other tokenization layers.
Authentication Requirements
1. Every balance request must include an X-API-Key header containing a valid credential issued by AgentHustle AI.
2. Keys are scoped to specific chains and permissions—attempting to query BSC with an Ethereum-only key results in HTTP 403.
3. Rate limits apply per key: 60 requests per minute across all endpoints, enforced at the API gateway level.
4. Invalid or expired keys trigger HTTP 401 with a JSON body indicating “invalid_api_key” or “key_expired”.
5. No session cookies or OAuth flows are involved; authentication is stateless and header-driven.
Response Structure and Data Fields
1. Successful responses use HTTP 200 and contain a top-level balance field expressed as a stringified integer in base units (e.g., wei for ETH, lamports for SOL).
2. A tokens array lists non-native assets, each with contractAddress, symbol, decimals, and rawBalance.
3. The lastUpdated field reports Unix timestamp in milliseconds, aligned with the underlying blockchain indexer’s latest synced block.
4. For wallets holding no tokens beyond native currency, the tokens array remains present but empty.
5. All numeric values are delivered as strings to prevent floating-point precision loss during JSON serialization.
ENS Name Resolution Integration
1. ENS names like vitalik.eth can be used directly in place of hexadecimal addresses when the resolver service is enabled.
2. The API automatically performs reverse lookup via Ethereum mainnet’s ENS registry before forwarding the query to the chain-specific balance endpoint.
3. Resolution fails silently if the name does not resolve to an address or points to an invalid checksummed format.
4. Supported ENS TLDs include .eth, .xyz, and .luxe; .com and .org are not processed unless registered in ENS-compatible resolvers.
5. PayPal and Venmo integrations allow PYUSD transfers using ENS names, but balance checks remain chain-native and do not reflect off-chain payment balances.
Frequently Asked Questions
Q: Can I check balances for wallets on unsupported chains like Cardano or Avalanche?A: No. The endpoint only supports Solana, Ethereum, Base, BSC, Polygon, Hedera, and Bitcoin. Requests for other chains return HTTP 400 with error code “unsupported_chain”.
Q: Does the API detect wrapped tokens like wBTC or wETH in Ethereum wallets?A: Yes. Wrapped tokens adhering to ERC-20 standards appear in the tokens array with their correct symbol, decimals, and raw balance.
Q: What happens if a wallet has zero balance across all assets?A: The response includes balance: '0' and an empty tokens array. HTTP status remains 200.
Q: Is there a way to batch-check multiple addresses in one request?A: Not natively. Each address requires a separate HTTP request. Clients must implement parallelization or queuing logic externally.
Disclaimer:info@kdj.com
The information provided is not trading advice. kdj.com does not assume any responsibility for any investments made based on the information provided in this article. Cryptocurrencies are highly volatile and it is highly recommended that you invest with caution after thorough research!
If you believe that the content used on this website infringes your copyright, please contact us immediately (info@kdj.com) and we will delete it promptly.
- Bybit, Anthropic, and the Shifting Sands of Stock Trading: A New York Minute on Wall Street's Digital Frontier
- 2026-11-20 12:30:03
- Ledger CTO's Departure Signals Evolving Crypto Asset Security Landscape Amidst New Threats
- 2026-11-20 08:35:01
- GTA VI Frenzy, Nvidia's AI Hurdles, and SpaceX's Texas Gamble: A Tech Trifecta
- 2026-11-20 04:35:01
- Egrag Crypto's XRP Investment Strategy: Patience, Not Perfection, for Holders
- 2026-11-20 04:35:01
- Bitcoin Price Plummets Amid Federal Reserve Rate Hike Fears and Crypto Crash
- 2026-11-19 12:30:02
- Navigating Geopolitical Storms: Portfolio Resilience, Wealth Preservation, and the Shifting Sands of Access
- 2026-11-19 12:45:01
Related knowledge
How to Send USDC From Backpack Wallet to Another Address
Nov 18,2026 at 05:40pm
Understanding USDC and Backpack Wallet Integration1. USDC is a fully reserved, regulated stablecoin backed 1:1 by U.S. dollars held in segregated acco...
How to Recover a Backpack Wallet With a Recovery Phrase
Nov 18,2026 at 06:59pm
Understanding the Backpack Wallet Recovery Phrase1. A recovery phrase for Backpack Wallet is a sequence of 12 or 24 English words generated during wal...
How to Enable DApp Browser in Trust Wallet
Nov 02,2026 at 07:00pm
Accessing the Built-in DApp Browser1. Open the Trust Wallet application on your mobile device. 2. Navigate to the bottom navigation bar and tap the DA...
How to Recover Missing USDT in Trust Wallet
Nov 03,2026 at 02:20pm
Understanding USDT Chain Mismatch in Trust Wallet1. USDT exists across multiple blockchains including Ethereum (ERC-20), BNB Smart Chain (BEP-20), Tro...
How to Check BNB Transaction Confirmations on Trust Wallet
Nov 03,2026 at 02:59am
Bitcoin Halving Mechanics1. Bitcoin’s protocol enforces a fixed issuance schedule where block rewards are cut in half approximately every 210,000 bloc...
How to Add Solana to Trust Wallet
Nov 03,2026 at 08:40am
Market Volatility Patterns1. Bitcoin price swings often exceed 10% within a 24-hour window during high-liquidity events such as ETF approval announcem...
How to Send USDC From Backpack Wallet to Another Address
Nov 18,2026 at 05:40pm
Understanding USDC and Backpack Wallet Integration1. USDC is a fully reserved, regulated stablecoin backed 1:1 by U.S. dollars held in segregated acco...
How to Recover a Backpack Wallet With a Recovery Phrase
Nov 18,2026 at 06:59pm
Understanding the Backpack Wallet Recovery Phrase1. A recovery phrase for Backpack Wallet is a sequence of 12 or 24 English words generated during wal...
How to Enable DApp Browser in Trust Wallet
Nov 02,2026 at 07:00pm
Accessing the Built-in DApp Browser1. Open the Trust Wallet application on your mobile device. 2. Navigate to the bottom navigation bar and tap the DA...
How to Recover Missing USDT in Trust Wallet
Nov 03,2026 at 02:20pm
Understanding USDT Chain Mismatch in Trust Wallet1. USDT exists across multiple blockchains including Ethereum (ERC-20), BNB Smart Chain (BEP-20), Tro...
How to Check BNB Transaction Confirmations on Trust Wallet
Nov 03,2026 at 02:59am
Bitcoin Halving Mechanics1. Bitcoin’s protocol enforces a fixed issuance schedule where block rewards are cut in half approximately every 210,000 bloc...
How to Add Solana to Trust Wallet
Nov 03,2026 at 08:40am
Market Volatility Patterns1. Bitcoin price swings often exceed 10% within a 24-hour window during high-liquidity events such as ETF approval announcem...
See all articles














