{"uid":"cap_FxrydD41bo-jduWNcZ6ZF","slug":"hyperliquid-live-long-short-ratio-bf66bebd","name":"Hyperliquid Live Long/Short Ratio","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/live/long-short","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_q7NSsHMbahPUMgxuTx3m3","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 real-time long/short position ratio and sentiment data for Hyperliquid perpetual markets, derived from first-party node fills ledger data.","exampleAgentPrompt":"What's the current live long/short ratio on Hyperliquid perp markets — are traders predominantly positioned long or short right now, and by how much?","exampleUseCases":[{"title":"Contrarian trade signal detection","prompt":"Pull the live long/short ratio from Hyperliquid right now — I want to see if the market is extremely one-sided so I can look for a contrarian fade opportunity."},{"title":"Pre-trade sentiment check for BTC perp","prompt":"Before I open a long on BTC perps, can you check the current long/short positioning data on Hyperliquid to see how crowded the long side is?"},{"title":"Market sentiment dashboard update","prompt":"Refresh the Hyperliquid long/short ratio data for my trading dashboard so I can track whether sentiment has shifted since this morning."}],"resultDescription":"Returns the current long/short ratio breakdown for Hyperliquid perpetual markets, including the percentage of open positions that are long versus short, derived from the operator's own node_fills ledger. May include per-asset breakdowns, aggregate sentiment metrics, and open interest distribution between longs and shorts.","failureModes":["Payment not included or insufficient USDC via x402 on Base — returns 402 Payment Required","Malformed POST body — returns 400 Bad Request","Node_fills ledger temporarily unavailable — may return 503 or stale data","Rate limits or network congestion on Base causing payment verification delays","Invalid or missing required body fields — returns validation error"],"whenToPreferThis":"Choose this endpoint when you need real-time, first-party long/short sentiment data specifically for Hyperliquid perpetual markets, computed directly from on-chain node_fills rather than aggregated third-party sources. Prefer this over generic crypto sentiment APIs when you need Hyperliquid-native positioning accuracy, and over Hyperliquid's own public API when you need enriched computed metrics beyond raw data. Best suited for agents building trading signals, sentiment dashboards, or risk monitoring around Hyperliquid perp markets.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:55:08.225Z","isFirstParty":false}