{"uid":"cap_4rQmYUEA9tMDIobdZhBtm","slug":"arkham-entity-balances-aa8a6e52","name":"Arkham Entity Balances","description":"Get Arkham token balances for an entity. $1.00 per call.","url":"https://api.arkm.com/x402/balances/entity","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"cheap":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"If 'true', uses a faster but less real-time balance query (up to 24 hours delayed)."},"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…"},"entity":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"The entity ID to query balances for."}}},"responseSchema":{"type":"json","example":{"balances":{"bsc":[{"id":"binance-bitcoin","usd":2658419407.091193,"name":"Binance Bitcoin","price":65027,"symbol":"BTCB","balance":40881.77844727871,"quoteTime":"2026-06-22T13:23:37.62Z","priceChange24h":950,"priceChange24hPercent":1.482591257393448}],"ethereum":[{"id":"tether","usd":40046128192.73723,"name":"Tether","price":1,"symbol":"USDT","balance":40046128192.73723,"quoteTime":"2026-06-22T13:24:28.299Z","priceChange24h":0,"priceChange24hPercent":0},{"id":"usd-coin","usd":7422685972.66057,"name":"USDC","price":1,"symbol":"USDC","balance":7422685972.66057,"quoteTime":"2026-06-22T13:24:30.156Z","priceChange24h":0,"priceChange24hPercent":0}]},"entities":{"binance":{"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","description":"","populatedTags":[{"id":"proof-of-reserves","rank":20,"label":"Binance Proof of Reserves","tagParams":"Binance","disablePage":false,"excludeEntities":false}]}},"totalBalance":{"bsc":11662208524.03351,"ethereum":66276809360.97472},"totalBalance24hAgo":{"bsc":11595187303.04529,"ethereum":65932976474.17882}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"1","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":"$1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Be4V_vXbDVYUSwWkgGgpi","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"1","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns on-chain token balances across multiple blockchains for a named entity (e.g. an exchange or wallet cluster) tracked by Arkham Intelligence.","exampleAgentPrompt":"Pull the current on-chain balances for Binance across all chains using Arkham — I want to see each token, its USD value, and how those holdings have changed in the last 24 hours.","exampleUseCases":[{"title":"Monitor exchange reserves in real time","prompt":"Show me all the on-chain token balances for Coinbase right now, broken down by blockchain, with total USD value — I want to track their reserve health."},{"title":"Track 24-hour balance change for a protocol","prompt":"What were Binance's on-chain holdings 24 hours ago versus right now? I want to see which chains moved the most in USD terms."},{"title":"Research institutional crypto treasury","prompt":"Pull the full multi-chain on-chain balance breakdown for the MakerDAO entity on Arkham — I need to know every token they hold and its current market value."}],"resultDescription":"A JSON object containing per-chain token balances (with token ID, name, symbol, USD value, raw balance, price, 24h price change, and quote timestamp), entity metadata (name, type, social links, description, tags), per-chain total balances, and a comparison of those totals from 24 hours ago.","failureModes":["Unknown or unrecognized entity ID returns an empty or error response","Payment of $1 USDC not received or rejected causes 402 Payment Required","Rate limiting or quota exceeded results in 429 Too Many Requests","Entity exists but has no indexed balances on any chain — returns empty balance arrays","Network or blockchain data lag may cause stale quote timestamps","Malformed POST body causes 400 Bad Request"],"whenToPreferThis":"Use this endpoint when you need comprehensive, multi-chain on-chain balance data for a named entity (exchange, protocol, institution) tracked by Arkham Intelligence. Prefer this over generic blockchain explorers when you want aggregated USD valuation across chains with a single call, or when you need the Arkham entity graph (name, type, social metadata) alongside the balance data. Best for institutional treasury monitoring, exchange reserve tracking, and on-chain due diligence on known crypto entities.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:33:19.735Z","isFirstParty":false}