{"uid":"cap_OEphQfZQ6ra4DXL0d9pyu","slug":"hyperliquid-trader-lifecycle-summary-bb5a1200","name":"Hyperliquid Trader Lifecycle Summary","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/lifecycle-summary","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_G2Zg3bID3NENYPM4aQ9aK","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 a comprehensive lifecycle summary for a specific Hyperliquid wallet address, including perpetual trading history, position lifecycles, and trader cohort classification","exampleAgentPrompt":"Pull the full lifecycle summary for Hyperliquid wallet 0x1234...abcd — I want to see their perp trading history, position lifecycles, and what trader cohort they fall into.","exampleUseCases":[{"title":"Profiling a whale trader's activity","prompt":"Give me a lifecycle summary for this Hyperliquid address 0xAbCd...1234 — I want to know their full perp trading history, which cohort they belong to, and how their positions have opened and closed over time."},{"title":"Assessing liquidation risk history","prompt":"Check the lifecycle summary for the Hyperliquid wallet 0xDEAD...BEEF and tell me if they've had any liquidations or been flagged for high liquidation risk in their trading history."},{"title":"Due diligence on a copy-trade candidate","prompt":"I'm thinking of copy-trading this Hyperliquid address 0x9999...AAAA — can you pull their lifecycle summary so I can see their track record, cohort classification, and how long they've been active on perps?"}],"resultDescription":"Returns a structured JSON object containing the full trading lifecycle for the specified wallet address, including perpetual fill records from the node_fills ledger, position open/close lifecycles, trader cohort classification, and liquidation risk indicators derived from first-party Hyperliquid data.","failureModes":["Invalid or malformed wallet address returns 400 error","Unknown address with no trading history may return empty or minimal payload","Payment of $0.001 USDC via x402 on Base must be completed or request is rejected with 402","Rate limits or node data lag may cause stale or incomplete fill data","Network issues with Hyperliquid public info API may result in partial data"],"whenToPreferThis":"Choose this endpoint when you need deep, first-party trading lifecycle data for a specific Hyperliquid wallet — including perp fills, position histories, and cohort classification — derived directly from a node_fills ledger rather than third-party aggregators. It is preferable when accuracy and provenance of data matter, when you need cohort or liquidation risk context not available from generic blockchain explorers, and when you want a single unified lifecycle summary rather than piecing together raw transaction data yourself.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:41:45.261Z","isFirstParty":false}