{"uid":"cap_uSugFeTaGbUNMdo0zwC1V","slug":"hyperliquid-trader-positions-1be49a32","name":"Hyperliquid Trader Positions","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/positions","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_crc-MGhZ1E1n3D6rLucML","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":"Fetches current and historical perpetual futures position data for Hyperliquid traders, including position lifecycles and risk metrics","exampleAgentPrompt":"Pull up all the current open perp positions for Hyperliquid wallet 0xAbC123... — I want to see the size, entry price, unrealized PnL, leverage, and liquidation price for each one.","exampleUseCases":[{"title":"Liquidation risk monitoring for a trader","prompt":"Check if wallet 0xDeF456... on Hyperliquid is close to getting liquidated — show me their current positions, leverage levels, and how far each one is from the liquidation price."},{"title":"Copy-trading research on a top wallet","prompt":"I want to see exactly what perp positions that top Hyperliquid trader at 0xABC789... is holding right now — give me the market, direction, size, and entry price for each one so I can decide whether to copy them."},{"title":"Portfolio exposure audit for a DeFi fund","prompt":"Pull all open Hyperliquid perpetual positions for our fund wallet 0x111AAA... and break down the total long vs short exposure by asset, including unrealized PnL and funding costs."}],"resultDescription":"Returns structured data about a trader's perpetual futures positions on Hyperliquid, including open position details (market, side, size, notional value, entry price, mark price, unrealized PnL, leverage, liquidation price) and position lifecycle history derived from the node_fills ledger.","failureModes":["Invalid or unrecognized wallet address returns empty result or 400 error","Wallet with no Hyperliquid activity returns empty positions array","Payment not completed via x402 on Base results in 402 Payment Required response","Malformed JSON body causes 400 Bad Request","Rate limits or node sync lag may cause stale or delayed position data","Unknown asset filters silently return no results"],"whenToPreferThis":"Choose this endpoint when you need accurate, first-party perpetual futures position data directly from Hyperliquid's own ledger — particularly when you need liquidation risk metrics, position lifecycle history, or PnL calculations that require fill-level data not available from generic on-chain indexers. Prefer this over third-party Hyperliquid wrappers because it computes from the operator's own node_fills ledger, not re-sold data. It requires only $0.001 USDC per call via x402 with no API key or account needed.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T19:27:04.063Z","isFirstParty":false}