{"uid":"cap_HK_3352AJ-G5OuaBr-6v_","slug":"zerion-wallet-positions-9ab42245","name":"Zerion Wallet Positions","description":"","url":"https://api.zerion.io/v1/wallets/:address/positions?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"],"properties":{"address":{"type":"string","description":"Wallet address (EVM 0x or Solana base58)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["data"],"properties":{"data":{"type":"array","items":{"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"}}},"description":"Array of JSON:API resource objects."},"links":{"type":"object","description":"Self and pagination links."}}}}}}},"responseSchema":null,"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_bvvUhch-rOhrRh1jzV-eP","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":"Fetches all DeFi and token positions held by a given wallet address across 40+ chains","exampleAgentPrompt":"What are all the DeFi positions and token holdings for wallet address 0x742d35Cc6634C0532925a3b844Bc454e4438f44e across all chains on Zerion?","exampleUseCases":[{"title":"Portfolio audit before token sale","prompt":"Can you pull up all the positions held in wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 so I can see exactly what tokens and DeFi positions it has before I decide what to sell?"},{"title":"DeFi exposure check for risk management","prompt":"I need to know every DeFi protocol position for the wallet 0xAb5801a7D398351b8bE11C439e05C5B3259aeC9B — which protocols is it exposed to and what are the balances?"},{"title":"Multi-chain holdings lookup for a Solana wallet","prompt":"Show me all the token positions for Solana wallet 7vfCXTUXx5WJV5JADk17DUJ4ksgau7utNKj4b963voxs — I want to see everything it holds across chains."}],"resultDescription":"Returns a JSON:API-formatted array of position resource objects, each containing an ID, resource type, and attributes describing the token or DeFi position (asset, protocol, balance, value, chain). Also includes pagination links for iterating over large portfolios.","failureModes":["Invalid or malformed wallet address returns an error or empty data array","Unsupported chain or address format may return no results","Rate limiting or payment failure (x402) if the $0.01 USDC per call fee is not satisfied","Wallet with no on-chain positions returns an empty data array","Network timeout if upstream chain indexers are slow"],"whenToPreferThis":"Use this endpoint when you need a comprehensive, interpreted snapshot of all positions (tokens and DeFi) held by a specific wallet across 40+ EVM chains and Solana. Prefer this over raw RPC calls or single-chain explorers when you need multi-chain aggregation with DeFi protocol attribution. It is ideal for portfolio dashboards, risk analysis, and on-chain due diligence where breadth of coverage matters.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T12:40:23.453Z","isFirstParty":false,"canonicalSlug":"zerion-wallet-positions-36e88b8e"}