{"uid":"cap_OMHts1gih5-t0asNzvCR2","slug":"hyperliquid-trader-position-lifecycles-ab98c045","name":"Hyperliquid Trader Position Lifecycles","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/lifecycles","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_TZ_rPwgqZ9QOr0Wof9-57","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 full position lifecycle history for traders on Hyperliquid perpetuals, tracing how positions were opened, modified, and closed over time.","exampleAgentPrompt":"Show me the full position lifecycle history for Hyperliquid wallet 0xAbC123... — I want to see how their perp positions were opened, held, and closed over the past 30 days.","exampleUseCases":[{"title":"Copy-trading candidate position audit","prompt":"I'm considering copy-trading this Hyperliquid wallet — can you pull the full position lifecycle history for 0xDef456... so I can see how long they typically hold perp positions, how they manage entries and exits, and what their realized PnL looks like across the last 60 days?"},{"title":"BTC position entry and exit trace","prompt":"Find out exactly when and how the trader at 0x789Ghi... opened and closed their BTC perpetual position on Hyperliquid — I want to see the entry price, any adjustments they made along the way, the exit, and the final realized PnL."},{"title":"Risk audit of trader position management","prompt":"I need to audit the position management history for Hyperliquid wallet 0xJkl012... — show me the birth-to-close lifecycle of all their perp trades so I can assess how they handle drawdowns, whether they average down, and how quickly they cut losing positions."}],"resultDescription":"An array of position lifecycle records derived from Hyperliquid's node_fills ledger, each describing the open event, intermediate fills or adjustments, close event, realized PnL, and total duration for a perpetual futures position held by the queried trader.","failureModes":["Invalid or unrecognized wallet address returns an error or empty result set","Wallet with no fill history returns an empty lifecycle array","Malformed request body (missing required fields) returns HTTP 400","Insufficient USDC balance or failed x402 payment returns HTTP 402","Upstream Hyperliquid API unavailability causes HTTP 503 or timeout","Querying a very active wallet with thousands of fills may result in slow response or pagination requirement"],"whenToPreferThis":"Use this endpoint when you need a structured, chronological view of how a trader's positions evolved from open to close on Hyperliquid perps — not just a flat list of fills. Ideal for performance attribution, risk auditing, copy-trading analysis, or understanding hold durations. Prefer this over raw fill endpoints when position-level granularity and lifecycle context (entry, adjustments, exit) matter more than individual trade events.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T22:26:30.113Z","isFirstParty":false}