{"uid":"cap_ymaxkSkQBthf22_0CGbnt","slug":"hyperliquid-trader-position-lifecycles-d1c16523","name":"Hyperliquid Trader Position Lifecycles","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/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":"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_Z7PhgIINW4t4kfEriyemv","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 a given Hyperliquid wallet address, including open, closed, and liquidated perpetual positions derived from the node_fills ledger.","exampleAgentPrompt":"Pull the full position lifecycle history for Hyperliquid wallet 0x1234567890abcdef1234567890abcdef12345678 — I want to see every perp position they've opened, closed, or got liquidated on.","exampleUseCases":[{"title":"Due diligence on a copy-trade target","prompt":"Before I start copy-trading this Hyperliquid wallet, can you pull the complete position lifecycle history for 0xAbCd1234567890abcdef1234567890abcdef1234 so I can see their track record — how many positions they've opened, closed profitably, and how often they've been liquidated?"},{"title":"Liquidation risk audit for a whale","prompt":"I want to audit the trading history of this suspected whale on Hyperliquid — fetch all position lifecycles for 0xDead1234567890abcdef1234567890abcdefBEEF and tell me how frequently they've been liquidated and what their typical position sizes look like."},{"title":"Retrospective performance analysis","prompt":"Can you reconstruct the full trading lifecycle for my own Hyperliquid address 0xMy001234567890abcdef1234567890abcdef0001? I want a breakdown of every position I've ever held — when I opened it, when I closed it, and whether it was profitable or got liquidated."}],"resultDescription":"A structured list of position lifecycle records for the specified wallet address, each including the asset traded, entry and exit timestamps, fill prices, realized PnL, and whether the position was closed voluntarily or via liquidation — all sourced directly from Hyperliquid's node_fills ledger.","failureModes":["Invalid or malformed wallet address returns a 4xx error","Address with no trading history returns an empty result set","x402 payment failure (insufficient USDC balance or incorrect payment header) results in 402 Payment Required","Rate limiting or node unavailability may return 5xx errors","Address with extremely large fill history may result in slow or truncated responses"],"whenToPreferThis":"Choose this endpoint when you need the complete cradle-to-grave lifecycle of every perpetual position for a specific Hyperliquid wallet, sourced first-party from the node_fills ledger rather than third-party aggregators. It is preferable over generic on-chain explorers because it provides Hyperliquid-specific position semantics (entry, exit, liquidation events) in a single structured response, and requires no API key — only a micropayment of $0.001 USDC via x402 on Base.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:44:11.919Z","isFirstParty":false}