{"uid":"cap_eOkl4fkjCPI-MIP_lYzVI","slug":"hyperliquid-closed-positions-lookup-809f435f","name":"Hyperliquid Closed Positions 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/closed-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":"unknown","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_Kxi3lTHc4Pdg0ITWkoUhG","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":"Retrieves closed perpetual position history and lifecycle data for one or more Hyperliquid wallet addresses","exampleAgentPrompt":"Pull the closed perpetual position history for Hyperliquid wallet 0xABC123... and show me the realized PnL and trade duration for each position.","exampleUseCases":[{"title":"Trader performance review","prompt":"Show me all the closed perp positions for Hyperliquid wallet 0xABC123 over the last 30 days — I want to see realized PnL, which assets they traded, and how long each position was held."},{"title":"Copy trading due diligence","prompt":"Before I start copy-trading this Hyperliquid address, can you pull their closed position history and tell me their win rate and average realized gain per trade?"},{"title":"Tax and accounting export","prompt":"I need the full list of closed perpetual positions for my Hyperliquid wallet 0xDEF456 for the year — entry price, exit price, size, and realized PnL for each trade so I can hand it to my accountant."}],"resultDescription":"Returns a structured list of closed perpetual positions for the queried wallet(s), including entry and exit fill details, realized PnL, position size, asset traded, open/close timestamps, and trade duration — sourced directly from Hyperliquid's node_fills ledger.","failureModes":["Invalid or unrecognized wallet address returns empty result or 400 error","Wallet with no closed positions returns empty array","Payment not attached or insufficient USDC triggers 402 response requiring x402 payment on Base","Malformed request body returns validation error","Rate limiting or node unavailability may produce 503 or timeout"],"whenToPreferThis":"Choose this endpoint when you need authoritative, first-party closed position data for Hyperliquid perpetual traders sourced directly from the node_fills ledger — not aggregated third-party data. Ideal for realized PnL analysis, trader performance review, copy-trading vetting, or tax reporting. Prefer over generic on-chain explorers when you specifically need structured lifecycle data (entry, exit, duration, PnL) for Hyperliquid perps.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:44:42.066Z","isFirstParty":false}