{"uid":"cap_Tzm3_Fmd8JiHZXJaLpeeO","slug":"arkham-x402-wallet-balances-7745fd79","name":"Arkham x402 Wallet Balances","description":"Get Arkham token balances for an address. $0.20 per call.","url":"https://api.arkm.com/x402/balances/address","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"chains":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Chains to filter by, as a single comma-separated value (e.g. 'ethereum,bsc'). If omitted, returns balances across all s…"},"address":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"The blockchain address to query balances for."}}},"responseSchema":{"type":"json","example":{"balances":{"bsc":[{"id":"binance-bridged-usdt-bnb-smart-chain","usd":3734.28585101,"name":"Tether USD","price":1,"symbol":"USDT","balance":3734.28585101,"quoteTime":"2026-07-06T08:56:06.003Z","balanceExact":"3734285851010000000000","priceChange24h":0,"ethereumAddress":"0x55d398326f99059fF775485246999027B3197955","priceChange24hPercent":0}],"ethereum":[{"id":"tether","usd":933180509.069545,"name":"Tether USD","price":1,"symbol":"USDT","balance":933180509.069545,"quoteTime":"2026-07-06T08:56:21.074Z","balanceExact":"933180509069545","priceChange24h":0,"ethereumAddress":"0xdAC17F958D2ee523a2206206994597C13D831ec7","priceChange24hPercent":0},{"id":"ethereum","usd":466106814.4910013,"name":"Ethereum","price":1764.02,"symbol":"ETH","balance":264229.8922296807,"quoteTime":"2026-07-06T08:56:12.855Z","balanceExact":"264229892229680683921876","priceChange24h":-2.220000000000027,"priceChange24hPercent":-0.1256907328562385}]},"addresses":{"bsc":{"0x28C6c06298d514Db089934071355E5743bf21d60":{"chain":"bsc","address":"0x28C6c06298d514Db089934071355E5743bf21d60","contract":false,"arkhamLabel":{"name":"Hot Wallet","address":"0x28C6c06298d514Db089934071355E5743bf21d60","chainType":"evm"},"arkhamEntity":{"id":"binance","name":"Binance","note":"","type":"cex","service":null,"twitter":"https://twitter.com/binance","website":"https://binance.com","linkedin":"https://www.linkedin.com/company/binance","crunchbase":"https://www.crunchbase.com/organization/binance"},"isUserAddress":false}},"ethereum":{"0x28C6c06298d514Db089934071355E5743bf21d60":{"chain":"ethereum","address":"0x28C6c06298d514Db089934071355E5743bf21d60","contract":false,"arkhamLabel":{"name":"Hot Wallet","address":"0x28C6c06298d514Db089934071355E5743bf21d60","chainType":"evm"},"arkhamEntity":{"id":"binance","name":"Binance","note":"","type":"cex","service":null,"twitter":"https://twitter.com/binance","website":"https://binance.com","linkedin":"https://www.linkedin.com/company/binance","crunchbase":"https://www.crunchbase.com/organization/binance"},"isUserAddress":false}}},"totalBalance":{"bsc":4958.963746508313,"ethereum":1851859770.870929},"totalBalance24hAgo":{"bsc":4962.53510092634,"ethereum":1855389918.268125}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.2","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.2/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.2","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.2","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_n1qGuop9yHyDj91zt9xjI","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.2","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns token balances across multiple chains for one or more blockchain addresses, enriched with Arkham entity and label intelligence.","exampleAgentPrompt":"What tokens and USD balances does wallet 0x28C6c06298d514Db089934071355E5743bf21d60 hold on Ethereum and BSC right now, and which entity does Arkham say owns it?","exampleUseCases":[{"title":"On-chain portfolio snapshot for research","prompt":"Pull the current token balances and total USD value for 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 across all chains — I want to know what this wallet is holding and who Arkham thinks it belongs to."},{"title":"Exchange hot wallet monitoring","prompt":"Check the Arkham balances for 0x28C6c06298d514Db089934071355E5743bf21d60 and tell me how much USDT and ETH it holds right now, along with the Arkham entity label."},{"title":"Due diligence on counterparty wallet","prompt":"I need to verify the on-chain holdings of wallet address 0x3f5CE5FBFe3E9af3971dD833D26bA9b5C936f0bE — can you pull its balances per token and chain from Arkham and tell me if it's linked to any known entity?"}],"resultDescription":"A JSON object containing per-chain token balances (with USD value, raw balance, token price, 24h price change, quote timestamp, and Ethereum contract address), plus address-level metadata including Arkham entity identification (name, type, social links) and Arkham label (e.g. 'Hot Wallet').","failureModes":["Invalid or malformed address returns an error or empty balances","Address with no on-chain activity returns empty balance arrays","Unsupported chain not included in response","Payment failure via x402 protocol results in 402 response with no data","Rate limiting or quota exhaustion returns appropriate HTTP error","Network or RPC latency may cause stale quote timestamps"],"whenToPreferThis":"Choose this endpoint when you need multi-chain token balances enriched with Arkham's proprietary entity intelligence (exchange labels, fund identifications, etc.) in a single call. Prefer it over generic blockchain RPC calls when entity attribution matters, or over block explorers when you need structured, USD-denominated data with price context. Best for on-chain research, compliance checks, and portfolio analysis where knowing who owns the wallet is as important as what it holds.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:46:37.337Z","isFirstParty":false}