{"uid":"cap_pu7300dx_ukOtpnVAchiS","slug":"arkham-portfolio-time-series-by-address-11186725","name":"Arkham Portfolio Time-Series by Address","description":"Get Arkham daily portfolio time series for an address token. $0.40 per call.","url":"https://api.arkm.com/x402/portfolio/time-series/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,arbitrum_one'). If omitted, returns data across…"},"address":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"The blockchain address to query time series data for."},"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":{"2024-11-06T00:00:00Z":{"ethereum":{"ethereum":{"id":"ethereum","usd":182031320.5595918,"name":"Ethereum","price":2423.42,"symbol":"eth","balance":75113.401952444}},"arbitrum_one":{"ethereum":{"id":"ethereum","usd":382.8576735364209,"name":"Ethereum","price":2423.42,"symbol":"eth","balance":0.157982385858176}}}}},"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_lynz6-FmgCiU9QXh-mdgA","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 time-series portfolio value and token balance data for a given blockchain wallet address across networks","exampleAgentPrompt":"Pull the time-series portfolio history for Ethereum wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 from Arkham — I want to see how its holdings across Ethereum mainnet and Arbitrum changed over November 2024.","exampleUseCases":[{"title":"Whale wallet historical tracking","prompt":"Show me the portfolio value over time for the wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 — I want to see how its ETH holdings on Ethereum mainnet evolved through Q4 2024."},{"title":"DeFi fund performance audit","prompt":"Pull the time-series portfolio data for address 0xBE0eB53F46cd790Cd13851d5EFf43D12404d33E8 so I can audit how the fund's value changed week by week over the last quarter, broken down by chain."},{"title":"On-chain portfolio growth analysis","prompt":"I'm researching a wallet suspected to be a top trader — get me Arkham's historical portfolio time-series for 0xF977814e90dA44bFA03b6295A0616a897441aceE so I can see how its token balances grew across Arbitrum and Ethereum over 2024."}],"resultDescription":"A JSON object keyed by ISO 8601 timestamps, each containing a breakdown by blockchain network and token: includes asset ID, token name, symbol, current price in USD, token balance, and total USD value. Covers multiple chains (e.g. Ethereum mainnet, Arbitrum One) in a single response.","failureModes":["Invalid or unrecognized wallet address returns empty or error response","Insufficient USDC balance for x402 payment results in payment failure and no data returned","Address with no on-chain history returns empty time-series object","Unsupported network or chain parameter returns partial or null data","Rate limiting or API key issues result in 401/429 errors"],"whenToPreferThis":"Use this endpoint when you need time-series historical portfolio data for a specific blockchain wallet address, including per-token balances and USD valuations across multiple chains. Prefer this over simple balance lookups when trend analysis, historical snapshots, or time-windowed portfolio performance is needed. Arkham is especially valuable when the wallet belongs to a known entity or institution indexed in Arkham's intelligence graph.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:52:47.333Z","isFirstParty":false}