{"uid":"cap_Nm2NyEHz9Njmf9lJitra7","slug":"hyperliquid-trader-closed-positions-63b02b15","name":"Hyperliquid Trader Closed 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/%7Baddress%7D/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_K92Z4xyrEm5Pso-6gMri5","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 the complete history of closed perpetual trading positions for a specific Hyperliquid wallet address, including position lifecycle data derived from the node_fills ledger.","exampleAgentPrompt":"Pull up all the closed perpetual positions for Hyperliquid wallet 0xAbCd1234... — I want to see the full position lifecycle history including entry, exit, and realized PnL for each trade.","exampleUseCases":[{"title":"Audit a copy-traded wallet's track record","prompt":"I've been copy-trading this Hyperliquid address 0x7f3a9b... — can you pull all their closed positions so I can see how their historical trades actually performed before I keep following them?"},{"title":"Tax reporting for realized gains","prompt":"I need to review all the closed perp positions for my Hyperliquid wallet 0xDeAdBeEf... for this tax year — fetch the complete closed position history so I can calculate my realized gains and losses."},{"title":"Leaderboard trader due diligence","prompt":"This wallet 0x1a2b3c4d... is near the top of the Hyperliquid leaderboard — fetch all their closed positions so I can see what strategies and markets they've actually been trading."}],"resultDescription":"A list of closed perpetual position records for the specified wallet address, each containing position lifecycle details such as the asset/market traded, entry and exit prices, position size, realized PnL, open and close timestamps, and fill references sourced from the Hyperliquid node_fills ledger.","failureModes":["Invalid or malformed wallet address returns an error or empty result","Wallet address with no trading history returns an empty positions array","Endpoint returns 402 Payment Required if x402 micropayment of $0.001 USDC on Base is not completed","Rate limiting or node data lag may cause delayed or partial results","POST body missing required fields causes a 400 Bad Request"],"whenToPreferThis":"Choose this endpoint when you need the complete closed-position history for a specific Hyperliquid wallet address, especially when you want first-party data computed directly from Hyperliquid's node_fills ledger without relying on third-party data aggregators. It is ideal for per-address trade audits, PnL analysis, copy-trading due diligence, and tax reporting on Hyperliquid perp trades.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:42:56.510Z","isFirstParty":false}