{"uid":"cap_XDUMJ36x8seVlZ2cLiqpU","slug":"zerion-wallet-portfolio-chart-b9e0e6b7","name":"Zerion Wallet Portfolio Chart","description":"Interpreted wallet data for more than 40 chains and Solana: portfolios, DeFi positions, PnL, transactions and NFTs. REST for apps, x402 pay-per-call for agents.","url":"https://api.zerion.io/v1/wallets/%7Baddress%7D/charts/%7Bchart_period%7D?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["address","chart_period"],"properties":{"address":{"type":"string","description":"Wallet address"},"chart_period":{"enum":["1h","1d","1w","1m","3m","1y","max"],"type":"string"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["data"],"properties":{"data":{"type":"object","properties":{"id":{"type":"string","description":"Resource ID."},"type":{"type":"string","description":"Resource type."},"attributes":{"type":"object","description":"Resource attributes; see https://developers.zerion.io"}}},"links":{"type":"object","description":"Self and pagination links."}}}}}}},"responseSchema":{"type":"json","example":{"data":{"id":"<resource id>","type":"<resource type>","attributes":{}},"links":{"self":"https://api.zerion.io/v1/..."}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_rNlJp8W8XNiyIZb2v_olL","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns time-series chart data for a wallet's total portfolio value over a specified time period across 40+ chains and Solana","exampleAgentPrompt":"Can you pull the 3-month portfolio value chart for wallet 0x742d35Cc6634C0532925a3b844Bc454e4438f44e using Zerion so I can see how its total holdings have trended?","exampleUseCases":[{"title":"DeFi portfolio performance review","prompt":"Show me the 1-year portfolio value chart for wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 — I want to see how this wallet's total value has moved over the past year across all chains."},{"title":"Weekly trading performance snapshot","prompt":"Pull the 1-week chart for wallet 0xAb5801a7D398351b8bE11C439e05C5B3259aeC9B so I can see how the portfolio value changed over the last 7 days."},{"title":"All-time wallet growth analysis","prompt":"Get me the all-time (max period) portfolio chart for wallet 0x4838B106FCe9647Bdf1E7877BF73cE8B0BAD5f97 on Zerion — I'm trying to understand how this address has grown since its earliest activity."}],"resultDescription":"A JSON object containing chart data for the wallet's total portfolio value over the requested time period, including a data object with resource ID, resource type, and attributes (time-series value points), plus a self link for the query.","failureModes":["Invalid or malformed wallet address returns an error or empty result","Unsupported chart_period value outside the allowed enum returns a validation error","Wallet with no history for the requested period may return empty data attributes","Payment failure (x402) if USDC balance is insufficient blocks the request","Rate limiting or authentication errors if x402 payment is not correctly handled"],"whenToPreferThis":"Use this endpoint when you need historical portfolio value chart data for a specific wallet address across multiple chains. Prefer it over generic block explorers when you want interpreted, aggregated multi-chain portfolio value time-series rather than raw transaction lists. Ideal for agents building performance dashboards, tracking wallet growth, or comparing portfolio trajectories over defined time windows.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-29T18:51:21.501Z","isFirstParty":false,"canonicalSlug":"zerion-wallet-portfolio-chart-b9e0e6b7"}