{"uid":"cap_1SsOp9LoI5U_8gew0shVi","slug":"phantom-api-hyperliquid-token-balances-610f36ee","name":"Phantom API — Hyperliquid Token Balances","description":"Lightning-fast access to blockchain data, smart contract insights, and Web3 infrastructure across 57+ networks. Pay-per-call via x402.","url":"https://phantom-api-omega.vercel.app/api/hyperliquid/token/balances?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"owner":{"type":"string"},"contractAddresses":{"type":"array","items":{"type":"string"}}}},"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_3luvKDR0wnD_y7YuKMWAg","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 token balances for a given wallet address on Hyperliquid, optionally filtered by specific contract addresses.","exampleAgentPrompt":"What are the current token balances for the Hyperliquid wallet 0xAbC123...? Include balances for contract addresses 0xToken1 and 0xToken2.","exampleUseCases":[{"title":"Portfolio balance check for DeFi trader","prompt":"Can you pull all the token balances for my Hyperliquid wallet 0x4f3eA1b2c3D4e5F6a7B8c9D0e1F2a3B4c5D6e7F8 so I can see what I'm holding?"},{"title":"Monitor specific token holdings on-chain","prompt":"Check the balance of these two tokens — 0xAAA111... and 0xBBB222... — in the Hyperliquid wallet 0xDeadBeef... and let me know how much I have of each."},{"title":"Audit wallet assets before a trade","prompt":"Before I make a move, look up all the token balances sitting in 0x1234567890abcdef1234567890abcdef12345678 on Hyperliquid so I know exactly what's available."}],"resultDescription":"Returns a list of token balances for the specified wallet owner on Hyperliquid, showing token identifiers and corresponding amounts. When contract addresses are provided, results are filtered to only those tokens.","failureModes":["Invalid or malformed owner address returns an error","Unrecognized contract address returns empty or null balance","Wallet with no holdings returns empty balance array","Network or upstream Hyperliquid API downtime causes timeout or 503","Malformed request body (missing owner field) results in 400 Bad Request"],"whenToPreferThis":"Use this endpoint when you need real-time token balance data specifically from the Hyperliquid network for a given wallet. It is ideal when you need to check holdings before executing a trade, audit a portfolio, or monitor specific token positions on Hyperliquid. Prefer this over generic multi-chain balance APIs when Hyperliquid-specific data is required.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-20T18:44:47.274Z","isFirstParty":false,"canonicalSlug":"phantom-api-hyperliquid-token-balances-610f36ee"}