{"uid":"cap_DCmWE6TFkpMWVbnKeoQ-v","slug":"hyperliquid-trader-lifecycle-summary-9b5e2a2a","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/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":"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_k7AJTL7-WqN9x0TD1oKgb","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 Hyperliquid trader including perp fill history, position open/close events, and trading tenure metrics derived from first-party node fills data.","exampleAgentPrompt":"Pull the full trading lifecycle summary for Hyperliquid wallet 0x1234...abcd — I want to see when they first traded, their position history, and overall activity span on the perps market.","exampleUseCases":[{"title":"Due diligence on a copy-trade candidate","prompt":"Before I start copy-trading this Hyperliquid wallet, can you pull their lifecycle summary so I can see how long they've been active, how many positions they've opened and closed, and whether their track record is recent or old?"},{"title":"Researching a top leaderboard trader","prompt":"I see this address near the top of the Hyperliquid leaderboard — give me a lifecycle summary for wallet 0xDEAD...BEEF so I understand their full trading history and when they became active."},{"title":"Auditing own trading tenure on Hyperliquid","prompt":"Can you pull my Hyperliquid lifecycle summary for wallet 0xMYWALLET so I can see a timeline of all my perp position opens and closes since I started trading?"}],"resultDescription":"A structured JSON object containing the trader's lifecycle on Hyperliquid: first and last activity timestamps, total number of fills, position open/close event timeline, trading tenure duration, and aggregated statistics derived from the node_fills ledger and Hyperliquid public info API.","failureModes":["Unknown or inactive wallet address returns empty lifecycle or 404-equivalent response","Malformed wallet address in request body causes 400 validation error","Payment not attached or insufficient USDC causes x402 payment required response","Rate limiting or node data lag may cause delayed or partial fill history","Wallet with no perp activity returns minimal or empty lifecycle object"],"whenToPreferThis":"Use this endpoint when you need a longitudinal, career-spanning profile of a specific Hyperliquid trader — covering when they started, their position open/close history, and fill counts — computed from first-party node_fills data rather than third-party aggregators. Prefer it over generic leaderboard or market endpoints when the goal is understanding a single trader's full activity arc rather than a point-in-time snapshot.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-16T00:28:00.174Z","isFirstParty":false}