{"uid":"cap_68BhxfmUNeQM4-8LZSClP","slug":"hyperliquid-trader-token-holdings-lookup-9d6d1333","name":"Hyperliquid Trader Token Holdings Lookup","description":"First-party Hyperliquid trading intelligence: perp fills, position lifecycles, all-wallet leaderboards, trader cohorts, liquidation risk and HIP-4 prediction markets - computed from our own node_fills ledger plus the Hyperliquid public info API (no third-party data source). Free discovery (/healthz, /v1/stats, /.well-known/x402, /v1/openapi.json) and free sample routes (/v1/markets/overview, /v1/assets); all other API calls are $0.001 USDC per request via x402 on Base (no account, no API key).","url":"https://hyperliquid-data.v1337.org/v1/traders/tokens","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"type":"object","description":"Operator-defined JSON payload. Probe the upstream or consult the operator's /openapi.json for the concrete shape.","additionalProperties":true},"type":{"type":"string","const":"http"},"method":{"enum":["POST","PUT","PATCH"],"type":"string"},"headers":{"type":"object","additionalProperties":{"type":"string"}},"bodyType":{"enum":["json","form-data","text"],"type":"string"},"queryParams":{"type":"object","additionalProperties":{"type":"string"}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","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":"down","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_41pCBMuNjsRmxrfOUDByS","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the token holdings or token-level trading data for traders on Hyperliquid, derived from first-party node fills and position data.","exampleAgentPrompt":"Show me which tokens the top Hyperliquid perp traders are holding or actively trading — I want to see a breakdown of token exposure across the leaderboard wallets.","exampleUseCases":[{"title":"Token exposure for a specific wallet","prompt":"Pull the token-level trading breakdown for Hyperliquid wallet 0xABC123 — I want to see which tokens they've been active in and their current positions."},{"title":"Find top traders in a token","prompt":"Which Hyperliquid traders are most active in ETH perps? Give me a ranked list of wallets by their fill volume or position size in that token."},{"title":"Token diversification across leaderboard","prompt":"I want to analyze how diversified the top 50 Hyperliquid leaderboard traders are — show me the token spread across their portfolios."}],"resultDescription":"Returns structured data mapping traders to their token-level activity on Hyperliquid, including positions, fill counts, volume, or holdings per token — sourced from first-party node fill ledger data.","failureModes":["Invalid or missing body payload returns 400 bad request","Wallet address not found in fill ledger returns empty result set","Payment not received or x402 handshake failure blocks the request","Malformed token symbol causes no matching results","Rate limiting or node sync lag may cause stale or delayed data"],"whenToPreferThis":"Choose this endpoint when you need first-party, node-sourced Hyperliquid trader token data without relying on third-party aggregators. It is ideal for investigating which tokens specific wallets trade, comparing token exposure across trader cohorts, or building analytics on Hyperliquid perp token activity. Prefer it over generic CEX or multi-chain analytics APIs when the focus is specifically on Hyperliquid perpetuals.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:26:54.120Z","isFirstParty":false}