{"uid":"cap_MEMWf4W13kWnNfmWRRtZE","slug":"arkham-x402-portfolio-by-address-f4c53320","name":"Arkham x402 Portfolio by Address","description":"Get Arkham portfolio history for an address. $0.20 per call.","url":"https://api.arkm.com/x402/portfolio/address","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"time":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Unix timestamp in milliseconds for the historical snapshot. The time is truncated to the start of the UTC day."},"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 data across all suppo…"},"address":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"The blockchain address to query portfolio history for."}}},"responseSchema":{"type":"json","example":{"bsc":{"1inch":{"id":"1inch","usd":506.1975952,"name":"1INCH","price":0.45496,"symbol":"1inch","balance":1112.62},"alchemy-pay":{"id":"alchemy-pay","usd":0.2132812,"name":"Alchemy Pay","price":0.02132812,"symbol":"ach","balance":10}},"ethereum":{"0x":{"id":"0x","usd":3710766.766003987,"name":"0x Protocol","price":0.369874,"symbol":"zrx","balance":10032515.8459475},"1inch":{"id":"1inch","usd":2759727.17734319,"name":"1INCH","price":0.45496,"symbol":"1inch","balance":6065867.718795477}}}},"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_KwUBLRXVwL0l8agCyxrtV","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 a breakdown of token holdings and USD values for a given blockchain wallet address across multiple chains","exampleAgentPrompt":"Pull up the full token portfolio for wallet address 0x3f5CE5FBFe3E9af3971dD833D26bA9b5C936f0bE — I want to see all their holdings broken down by chain and token with current USD values.","exampleUseCases":[{"title":"Whale wallet asset breakdown","prompt":"Look up everything held in this wallet — 0x3f5CE5FBFe3E9af3971dD833D26bA9b5C936f0bE — I want to know what tokens they're holding across Ethereum and BSC and how much each is worth in USD right now."},{"title":"DeFi research due diligence","prompt":"Before I copy this trader's strategy, can you pull their wallet portfolio for 0xAb5801a7D398351b8bE11C439e05C5B3259aec9B and show me what they're actually holding and the total USD breakdown?"},{"title":"On-chain portfolio monitoring","prompt":"Check the current token holdings for the address 0xBE0eB53F46cd790Cd13851d5EFf43D12404d33E8 — I need the balance and USD value of each token on every chain they use."}],"resultDescription":"A nested JSON object keyed first by blockchain (e.g. 'ethereum', 'bsc') and then by token identifier, containing each token's name, symbol, price in USD, balance quantity, and total USD value of that holding.","failureModes":["Invalid or malformed wallet address returns an error response","Address with no holdings may return empty chain objects","Unsupported chain returns no data for that chain","Rate limiting or insufficient USDC payment triggers 402 response","Network timeout on slow RPC lookups"],"whenToPreferThis":"Choose this endpoint when you need a comprehensive, multi-chain token portfolio breakdown for a specific wallet address with real USD valuations, especially when Arkham's proprietary wallet intelligence and entity labeling is relevant. Prefer this over generic block explorers when you need structured, machine-readable data ready for analysis rather than human-readable pages.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:50:08.077Z","isFirstParty":false}