{"uid":"cap_9rcNX1OpEtL4RRyUa_tJO","slug":"hyperliquid-closed-positions-lookup-d0ecf763","name":"Hyperliquid Closed Positions Lookup","description":"Operator-neutral Hyperliquid trading intelligence — perp fills, position lifecycles, all-wallet leaderboards, trader cohorts, liquidation risk and prediction markets. Every endpoint is FIRST-PARTY: computed from our own node_fills ledger and the Hyperliquid public info API (no third-party data source). Free quota, then HTTP 402 (x402: pay-per-call in USDC, no account, no key).","url":"https://hyperliquid-data.v1337.org/services/hyperliquid-data/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":"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_h5Afw5O_31GxbozRWsP-A","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 futures position lifecycles for traders on the Hyperliquid exchange, computed from first-party node fill data.","exampleAgentPrompt":"Pull all closed perpetual positions for Hyperliquid wallet 0xABCD...1234 — I want to see the entry price, exit price, and realized PnL for each trade they've completed.","exampleUseCases":null,"resultDescription":"A list of closed perpetual futures positions for the queried wallet, including entry/exit prices, realized PnL, position size, leverage, direction (long/short), asset pair, and open/close timestamps — all computed from the operator's first-party node_fills ledger.","failureModes":["Invalid or unrecognized wallet address returns empty results or 400 error","Wallet with no closed positions returns empty array","HTTP 402 returned when free quota is exhausted, requiring x402 USDC micropayment to proceed","Malformed POST body or missing required fields returns 400 or 422 validation error","Upstream Hyperliquid node data lag may cause recently closed positions to not yet appear","Rate limiting or node sync issues may cause transient 503 errors"],"whenToPreferThis":"Use this endpoint when you need historical closed position data for a specific Hyperliquid perpetuals trader — particularly for realized PnL analysis, trade history review, or position lifecycle research. Prefer this over open-position endpoints when the goal is to evaluate completed trades. Choose this over third-party aggregators because it uses first-party node_fills data, ensuring accuracy without dependency on external data providers.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T17:28:02.587Z","isFirstParty":false}