{"uid":"cap_7YyG-Bl_Z33nq0gAry4Bo","slug":"hyperliquid-token-balances-api-0dd66feb","name":"Hyperliquid Token Balances API","description":"High-speed API suite for AI processing, web scraping, and smart data utilities across 57+ blockchain networks. Pay-per-call via x402.","url":"https://synapse-api-brown.vercel.app/api/hyperliquid/token/balances","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_neMp0TWGctrKFERkABxEO","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 the Hyperliquid blockchain network, optionally filtered by specific contract addresses.","exampleAgentPrompt":"What token balances does wallet 0xAbC123...def456 currently hold on Hyperliquid? Include balances for contract addresses 0x111... and 0x222... if you can.","exampleUseCases":[{"title":"Portfolio snapshot for Hyperliquid trader","prompt":"Can you pull up all the token balances for my Hyperliquid wallet 0xDeF789... so I can see what I'm currently holding?"},{"title":"Multi-token DeFi position check","prompt":"Check the balances of these two token contracts — 0xToken1... and 0xToken2... — for wallet 0xMyWallet... on Hyperliquid."},{"title":"Automated balance monitoring alert","prompt":"Look up the current token balances for wallet 0xFund123... on Hyperliquid and tell me if any holdings have dropped below normal levels."}],"resultDescription":"Returns a list of token balances associated with the specified owner wallet on Hyperliquid, including token identifiers and amounts. When contract addresses are provided, results are filtered to only those specific tokens.","failureModes":["Invalid or malformed wallet address returns an error or empty result","Contract addresses that don't exist on Hyperliquid return zero or null balances","Network or API downtime results in a timeout or 5xx error","Unrecognized contract address format may cause a parsing error","Owner address with no Hyperliquid activity returns an empty balance list"],"whenToPreferThis":"Use this endpoint when you need to query token balances specifically on the Hyperliquid network for a given wallet. Prefer it over generic multi-chain balance APIs when the user is explicitly working within the Hyperliquid ecosystem, especially for DeFi portfolio tracking, position monitoring, or auditing token holdings on that specific chain.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:49:32.824Z","isFirstParty":false}