{"uid":"cap_AzpyKeXiGtkohG1fkkQ-c","slug":"bykaranteli-hyperliquid-positions-hourly-history-afa7037b","name":"ByKaranteli Hyperliquid Positions Hourly History","description":"Every open position of the 1000 largest Hyperliquid accounts by equity once an hour: address, coin, signed size, notional, entry and liquidation price, leverage and account equity, recorded from 2026-09-30, newest hour first; filter by coin, address and time. The free /api/public/hyperliquid-positions serves the live liquidation bands and hourly totals, never per position rows.","url":"https://bykaranteli.com/api/x402/hl-positions-history?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","properties":{"to":{"type":"string","description":"iso, optional, default now"},"from":{"type":"string","description":"iso, optional, default 7 days ago"},"limit":{"type":"number","description":"number, optional, max 20000"},"symbol":{"type":"string","description":"string, optional coin, e.g. BTC"},"address":{"type":"string","description":"string, optional account, 0x and 40 hex characters"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.1","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.1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_HVPZE3ALBbNeTQHnR1DI6","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.1","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns per-position hourly snapshots of every open trade held by the 1000 largest Hyperliquid accounts by equity, filterable by coin, address, and time range.","exampleAgentPrompt":"Pull hourly position history for the top 1000 Hyperliquid accounts on BTC from 2025-06-01 to 2025-06-07, up to 500 rows, so I can see their entry prices, leverage, and liquidation levels over that week.","exampleUseCases":[{"title":"Whale position liquidation risk analysis","prompt":"Show me the open ETH positions held by the 1000 largest Hyperliquid accounts over the past 48 hours — I want to see their entry prices, liquidation prices, and leverage to identify who was closest to getting liquidated."},{"title":"Tracking a specific trader's position history","prompt":"Get me the full position history for Hyperliquid address 0x1234567890abcdef1234567890abcdef12345678 over the last 7 days, all coins, up to 1000 rows newest first."},{"title":"Monitoring large SOL longs before a price move","prompt":"What BTC positions were the top 1000 Hyperliquid accounts by equity holding between 2026-01-10 and 2026-01-12? I want to see signed size, notional, and their account equity at each hourly snapshot."}],"resultDescription":"A list of per-position hourly records for the top 1000 Hyperliquid accounts by equity, each row containing account address, coin, signed size, notional value, entry price, liquidation price, leverage, account equity, and the snapshot timestamp. Results are ordered newest hour first and can be filtered by coin symbol, account address, and time range.","failureModes":["Invalid address format (not 0x + 40 hex chars) returns an error","Requesting data before 2026-09-30 (the history start date) returns empty results","Exceeding the 1000-row default or 20000-row max limit truncates results silently","Invalid ISO timestamp format in from/to parameters causes a parse error","Payment failure or insufficient USDC credit returns a 402 Payment Required response"],"whenToPreferThis":"Use this endpoint when you need granular per-position row data for the largest Hyperliquid accounts historically — specifically when you need entry price, liquidation price, leverage, and size at an individual position level over time. The free /api/public/hyperliquid-positions endpoint only provides live liquidation bands and hourly aggregated totals, not per-position rows. Prefer this when doing whale tracking, liquidation risk analysis, or backtesting based on actual large-account positioning.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-16T18:31:22.374Z","isFirstParty":false,"canonicalSlug":"bykaranteli-hyperliquid-positions-hourly-history-afa7037b"}