{"uid":"cap_2pKvpLzNIWjJNSLfiSR3N","slug":"arkham-x402-entity-portfolio-dc3c16aa","name":"Arkham x402 Entity Portfolio","description":"Get Arkham portfolio history for an entity. $0.40 per call.","url":"https://api.arkm.com/x402/portfolio/entity","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…"},"entity":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"The entity ID to query portfolio history for. Accepts an Arkham entity ID or a user entity ID."}}},"responseSchema":{"type":"json","example":{"bsc":{"2049":{"id":"2049","usd":1605.8928,"name":"2049","price":0.01338244,"symbol":"2049","balance":120000},"aave":{"id":"aave","usd":34023851.49966592,"name":"Aave","price":109.13,"symbol":"aave","balance":311773.5865450922}},"ethereum":{"0x":{"id":"0x","usd":26797375.46937224,"name":"0x Protocol","price":0.369874,"symbol":"zrx","balance":72450011.27241233},"1inch":{"id":"1inch","usd":61415514.90892401,"name":"1INCH","price":0.45496,"symbol":"1inch","balance":134991020.9884913}}}},"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_oOgYgAixpoNywmYIaZS-P","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 the full token portfolio (balances, USD values, prices) for a named blockchain entity across all tracked chains.","exampleAgentPrompt":"Pull the full token portfolio for the Arkham entity 'jump-trading' — I want to see all their holdings across every chain with current USD values and balances.","exampleUseCases":[{"title":"Hedge fund on-chain holdings audit","prompt":"Pull the complete on-chain portfolio for the Arkham entity 'alameda-research' — I need every token they hold across all chains with USD values and balances."},{"title":"DeFi protocol treasury monitoring","prompt":"What tokens and how much USD does the Aave protocol treasury entity hold right now? Show me the breakdown by chain and token."},{"title":"Competitive crypto fund analysis","prompt":"Get me the full portfolio breakdown for the entity 'paradigm' on Arkham — I want to see which tokens they're holding, their balances, and the current dollar values across all blockchains."}],"resultDescription":"A nested JSON object keyed by blockchain name, then by token ID, containing each token's name, symbol, balance (raw units), current price (USD), and total USD value held by the entity. Multiple chains (e.g. Ethereum, BSC) are returned in a single response.","failureModes":["Unknown or misspelled entity name returns empty or 404 response","Insufficient USDC balance causes x402 payment failure before data is returned","Entity with no tracked holdings returns empty portfolio object","Rate limiting or API key issues result in 401/429 errors","Stale price data may cause USD values to lag real-time market prices"],"whenToPreferThis":"Use this endpoint when you need a comprehensive, cross-chain token portfolio for a known Arkham-labeled entity (exchange, fund, protocol, whale) rather than a raw wallet address. Prefer this over raw on-chain lookups when you want entity-level aggregation with USD valuations and token metadata already resolved. Best suited for DeFi research, competitive intelligence, and on-chain fund analysis where Arkham's entity labeling adds context beyond a plain address query.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:49:22.723Z","isFirstParty":false}