{"uid":"cap_1lHs5GSEnGNXIXEEdcLcO","slug":"hyperliquid-live-long-short-history-d242e220","name":"Hyperliquid Live Long/Short History","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/history","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_cklqY0RYJs58R3dWr1B8U","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 historical long/short ratio time series for Hyperliquid perpetuals markets, computed from first-party node fill data.","exampleAgentPrompt":"Pull the long/short ratio history for BTC perps on Hyperliquid over the past 7 days so I can see how crowd positioning has shifted.","exampleUseCases":[{"title":"Crypto sentiment dashboard monitoring","prompt":"Give me the long/short ratio history for ETH-PERP on Hyperliquid over the last 24 hours — I want to see if sentiment has shifted since the price move this morning."},{"title":"Contrarian trading signal research","prompt":"Fetch the historical long/short breakdown for SOL perps on Hyperliquid for the past 30 days so I can look for extreme crowding events that preceded price reversals."},{"title":"Pre-trade positioning check","prompt":"Before I open a long on AVAX perps on Hyperliquid, can you check whether the market is already heavily long — pull the recent long/short ratio history for me."}],"resultDescription":"A time-series of long/short ratio snapshots for the requested Hyperliquid perpetual market, including timestamps, long percentage, short percentage, and potentially open interest or account count breakdowns, derived from the operator's node_fills ledger.","failureModes":["Unknown or unsupported asset symbol returns an error or empty series","Time range too far in the past may return no data if not stored in ledger","Malformed request body (missing required fields) returns a 400-level error","x402 payment failure or insufficient USDC balance blocks the request","Rate limits or network issues may cause timeouts on the upstream Hyperliquid API"],"whenToPreferThis":"Choose this endpoint when you need reliable, first-party long/short sentiment history for Hyperliquid perpetuals derived directly from the operator's own node fill ledger rather than third-party aggregators. It is ideal for on-chain DeFi analytics, contrarian signal research, or real-time market positioning checks specifically on the Hyperliquid DEX. Prefer this over generic crypto data APIs when you need Hyperliquid-native fill-level accuracy with micropayment access (no API key required).","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:56:11.673Z","isFirstParty":false}