{"uid":"cap_sFZGRrYQaK_aYKWrOZZOn","slug":"hyperliquid-position-lifecycle-analytics-ed487f4b","name":"Hyperliquid Position Lifecycle Analytics","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/analytics/lifecycle","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_p930R-_ufjmDonlX7OUuU","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 lifecycle history of perpetual positions on Hyperliquid, including entry, exit, funding, and liquidation events for a given wallet or asset","exampleAgentPrompt":"Pull the full position lifecycle for wallet 0xAbC...123 on Hyperliquid — I want to see when each perp position was opened and closed, any funding payments, and whether any were liquidated.","exampleUseCases":[{"title":"Audit a trader's position history","prompt":"Show me the complete lifecycle of all perpetual positions for wallet 0xDeF...456 on Hyperliquid — entry price, exit price, how long each was held, and whether any got liquidated."},{"title":"Analyze ETH-PERP position duration","prompt":"For wallet 0x789...abc on Hyperliquid, trace the lifecycle of their ETH-PERP positions over the last 30 days — I want to see fills, funding collected, and final PnL."},{"title":"Identify liquidated positions in a portfolio","prompt":"Check the position lifecycle history for wallet 0x111...222 on Hyperliquid and flag any positions that ended in liquidation, including the size and time it happened."}],"resultDescription":"A structured breakdown of perpetual position lifecycles for the queried wallet or market, including open/close fill events, timestamps, funding payments received or paid, realized PnL per position, and any liquidation events, all sourced from Hyperliquid's node_fills ledger.","failureModes":["Invalid or unrecognized wallet address returns empty result or 400 error","Unknown asset symbol causes request to fail with validation error","Payment not confirmed on Base chain results in 402 Payment Required response","Time range too broad may result in timeout or truncated dataset","Upstream Hyperliquid API outage causes 503 or degraded response"],"whenToPreferThis":"Choose this endpoint when you need a chronological, event-level breakdown of how a specific position evolved on Hyperliquid — from first fill through funding accrual to close or liquidation. Unlike simple balance or snapshot queries, this provides the full narrative arc of each trade, making it ideal for performance auditing, risk post-mortems, or trader profiling. Prefer this over generic DEX analytics when the target is specifically Hyperliquid perpetuals and you need event-level granularity computed from the node_fills ledger.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:54:48.616Z","isFirstParty":false}