{"uid":"cap__o8oFJ8rH5xWuOmUsgupH","slug":"hyperliquid-trading-intelligence-demo-trader-endpoint-fc084678","name":"Hyperliquid Trading Intelligence – Demo Trader Endpoint","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/demo","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_M5kTDOzNfkAxJIwm5A-rW","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 demo trader data from Hyperliquid including perp fills, position lifecycles, leaderboard rankings, cohort analytics, and liquidation risk metrics computed from first-party node data.","exampleAgentPrompt":"Pull the demo trader profile from the Hyperliquid Trading Intelligence service — I want to see their perp fill history, current position lifecycle, and any liquidation risk signals computed from first-party node data.","exampleUseCases":[{"title":"Top Hyperliquid traders by PnL","prompt":"Show me the current Hyperliquid leaderboard — I want to see which wallets are sitting at the top by PnL, what cohort they fall into, and any notable liquidation risk signals for the leaders."},{"title":"Liquidation risk for perp traders","prompt":"Pull liquidation risk metrics for active Hyperliquid perpetual traders right now — I want to know which wallets are most at risk of getting liquidated and what their current position lifecycles look like, all from first-party node data."},{"title":"Fill history for specific wallet","prompt":"Get the full perp fill history for this Hyperliquid trader wallet and break down their position lifecycle events — I want to understand their trading patterns and see how they're classified in the cohort analytics."}],"resultDescription":"Returns structured JSON containing demo trader data: perpetual fill records, position lifecycle events, leaderboard standing, cohort classification, and liquidation risk metrics — all sourced from the operator's own Hyperliquid node_fills ledger and the Hyperliquid public info API.","failureModes":["HTTP 402 if free quota is exhausted and no USDC payment is provided via x402 protocol","HTTP 400 if the required 'input' object is missing or malformed","HTTP 404 if the requested trader address does not exist in the ledger","Empty or minimal response if the demo trader has no fills or positions on record","Timeout if the Hyperliquid public info API is unresponsive"],"whenToPreferThis":"Choose this endpoint when you need first-party Hyperliquid perpetual trading data — fills, positions, leaderboard rankings, cohort analytics, or liquidation risk — without relying on any third-party data aggregator. Especially useful for agents that need operator-neutral, node-verified on-chain trading intelligence with pay-per-call pricing (no account or API key required).","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:39:54.575Z","isFirstParty":false}