{"uid":"cap_JjLXST3kDNBAUjpaT-_1S","slug":"arkham-entity-balance-changes-1da0f072","name":"Arkham Entity Balance Changes","description":"Get Arkham entity balance changes. $0.40 per call.","url":"https://api.arkm.com/x402/intelligence/entity-balance-changes","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"limit":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Number of results to return per page. Required; must be between 1 and 100."},"chains":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"List of chains to filter by."},"offset":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Number of results to skip from the beginning."},"orderBy":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Field to sort results by. One of: balanceUsd, balanceUsdChange, balanceUsdPctChange, balanceUnit, balanceUnitChange, ba…"},"interval":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Time interval for balance change calculation. One of '7d', '14d', or '30d'."},"orderDir":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Sort direction: 'asc' for ascending or 'desc' for descending."},"entityIds":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"List of specific entity IDs to filter by."},"balanceMax":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Maximum balance threshold in USD to filter entities."},"balanceMin":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Minimum balance threshold in USD to filter entities."},"entityTags":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"List of entity tags to include. Requires elevated access; requests using this parameter without it may return 403."},"pricingIds":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"List of CoinGecko pricing IDs to filter by."},"entityTypes":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"List of entity types to filter by."},"negatedEntityTags":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"List of entity tags to exclude. Requires elevated access; requests using this parameter without it may return 403."}}},"responseSchema":{"type":"json","example":[{"entityId":"binance","balanceUsd":128882055209.1815,"entityName":"Binance","entityType":"cex","balanceUnit":2.588710860077077e+30,"tokenBalances":[{"tokenId":"bitcoin","balanceUsd":42777592075.57917,"balanceUnit":665902.74090254,"tokenSymbol":"btc","prevBalanceUsd":43238665627.32252,"prevBalanceUnit":671251.50395595},{"tokenId":"ethereum","balanceUsd":7084063789.738129,"balanceUnit":4073033.238123183,"tokenSymbol":"eth","prevBalanceUsd":6660434374.533453,"prevBalanceUnit":3964473.476386405}],"prevBalanceUsd":128959949999.76,"prevBalanceUnit":2.588710860077077e+30}]},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.4","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.4/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.4","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.4","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_De6omfbTyDj_fuTAA6AfC","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.4","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns current and previous USD/unit balances for a crypto entity (e.g. exchange, wallet) broken down by token, enabling detection of balance changes.","exampleAgentPrompt":"Pull the current and previous balance breakdown for Binance from Arkham — I want to see how their Bitcoin and Ethereum holdings have changed, in both USD and native units.","exampleUseCases":[{"title":"Detecting exchange fund movements","prompt":"Check Arkham's entity balance data for Binance and tell me if their total crypto holdings have gone up or down since the last snapshot — I want to see the per-token breakdown too."},{"title":"Monitoring whale wallet holdings","prompt":"I want to track how much Bitcoin and Ethereum Coinbase holds right now versus before — pull the balance changes from Arkham so I can see if there's been any significant movement."},{"title":"Research on institutional crypto positions","prompt":"Can you get me a breakdown of FTX's token balances from Arkham, including what they held before, so I can compare current vs previous holdings across all tokens?"}],"resultDescription":"An array of entity balance objects, each containing the entity ID, name, type (e.g. 'cex'), current total balance in USD and native units, previous balance in USD and native units, and a nested array of per-token balances (token ID, symbol, current and previous USD and unit balances).","failureModes":["Unknown or invalid entity ID returns empty array or 404","Payment failure via x402 results in 402 response and no data","Rate limiting if too many requests in short period","Stale data if on-chain indexing is lagged","Entity with no tracked balances returns empty token balances array"],"whenToPreferThis":"Use this endpoint when you need to track balance changes for a named, labeled crypto entity (exchange, fund, whale wallet) identified by Arkham's intelligence graph — particularly when you want per-token USD and unit breakdowns with historical comparison. Prefer this over generic block explorers when you need entity-level attribution (e.g. 'Binance' rather than a raw address) and pre-computed USD valuations.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:58:01.238Z","isFirstParty":false}