{"uid":"cap_mKoxxayC3ztNiRl0kl2-q","slug":"arkham-portfolio-time-series-by-entity-b6a02973","name":"Arkham Portfolio Time-Series by Entity","description":"Get Arkham daily portfolio time series for an entity token. $0.60 per call.","url":"https://api.arkm.com/x402/portfolio/time-series/entity","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,arbitrum_one'). If omitted, returns data across…"},"entity":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"The entity ID to query time series data for. Accepts an Arkham entity ID or a user entity ID."},"pricingId":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"The CoinGecko pricing ID of the token to track."}}},"responseSchema":{"type":"json","example":{"2023-07-19T00:00:00Z":{"ethereum":{"ethereum":{"id":"ethereum","usd":7541947049.244255,"name":"Ethereum","price":1897.72,"symbol":"eth","balance":3974214.873239601}},"arbitrum_one":{"ethereum":{"id":"ethereum","usd":211904206.9619752,"name":"Ethereum","price":1897.72,"symbol":"eth","balance":111662.5250099989}}}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.6","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.6/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.6","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.6","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_c_OIjABeP_tB1aevLCdM7","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.6","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns historical portfolio value and token balances over time for a named blockchain entity, broken down by chain and asset.","exampleAgentPrompt":"Pull the Arkham portfolio time series for the entity 'Binance' from January 1 2023 to July 19 2023, broken down by chain and token.","exampleUseCases":[{"title":"Track whale portfolio over time","prompt":"Show me the historical portfolio breakdown for the Arkham entity 'Jump Trading' across all chains from January 2023 through June 2023 — I want to see USD values and token balances per chain."},{"title":"Monitor exchange reserve changes","prompt":"Get me the time-series data for Coinbase's on-chain holdings from Arkham from the start of 2023 to end of Q2, so I can see how their ETH reserves changed month by month."},{"title":"Research DeFi protocol treasury","prompt":"Pull Arkham's portfolio time series for the Uniswap DAO entity over 2023 — I need to see how their treasury value fluctuated across Ethereum and Arbitrum."}],"resultDescription":"A JSON object keyed by ISO 8601 timestamps, where each entry contains a nested breakdown by blockchain network and then by asset. Each asset entry includes the asset ID, name, ticker symbol, current price in USD, balance held, and total USD value. Covers all chains the entity has activity on.","failureModes":["Unknown or unresolved entity name returns empty result or 404","Date range outside available data returns empty time-series","Insufficient USDC balance for x402 payment causes request to fail with 402","Malformed entity identifier causes 400 bad request","Rate limiting or throttling if too many requests are issued rapidly"],"whenToPreferThis":"Use this endpoint when you need historical, time-stamped portfolio data for a known, labeled blockchain entity (e.g. exchange, fund, protocol DAO) rather than a raw address. It is ideal for trend analysis, charting portfolio evolution, or comparing cross-chain holdings at specific points in time. Prefer Arkham over generic on-chain RPC queries when you need human-readable entity labels and aggregated multi-wallet, multi-chain portfolio views.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:48:23.821Z","isFirstParty":false}