{"uid":"cap_yR4j9_LFxieZVb0nGPbGF","slug":"hyperextend-liquidations-coverage-b2aca137","name":"Hyperextend Liquidations Coverage","description":"Archive coverage for a coin's liquidations over a window (≤7 days): which archived hours hold liquidations and where the gaps are. Warms the cache for everyone after. Priced floor ($0.001) + $0.05 per archived hour examined.","url":"https://api.hyperextend.xyz/v1/liquidations/coverage","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","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":["coin","start","end"],"properties":{"end":{"type":"integer"},"coin":{"type":"string"},"start":{"type":"integer"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"dex":"main","coin":"BTC","gaps":[],"requested":{"end":3600000,"start":0},"last_liquidation_ms":3599000,"first_liquidation_ms":0,"archived_hours_examined":1,"hours_with_liquidations":1}},"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"end":1704153600,"coin":"BTC","start":1704067200}}},"response":{"dex":"main","coin":"BTC","gaps":[],"requested":{"end":1704153600,"start":1704067200},"last_liquidation_ms":null,"first_liquidation_ms":null,"archived_hours_examined":0,"hours_with_liquidations":0}},"exampleRequest":{"end":1704153600,"coin":"BTC","start":1704067200},"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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_zK6hd3fPuPdmjAXu4qPsv","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 coverage metadata for Hyperliquid per-minute liquidation data — gaps, first/last liquidation timestamps, and hours examined — for a given coin and time window.","exampleAgentPrompt":"Check the liquidation data coverage for BTC on Hyperliquid from timestamp 0 to 3600000 — I want to know if there are any gaps and when the first and last liquidations were recorded in that window.","exampleUseCases":null,"resultDescription":"A JSON object containing the coin and DEX identifier, the requested start/end window, a list of coverage gaps (if any), the timestamp of the first and last liquidation within the window, the number of archived hours examined, and the number of hours that had at least one liquidation.","failureModes":["Missing required query params (coin, start, end) returns 400 error","Invalid coin symbol returns empty or error response","Start timestamp greater than end timestamp may return error or empty result","No liquidation data found for the specified window returns empty gaps and zero hours","Payment not included or invalid returns 402 Payment Required","Very large time windows may time out or return partial results"],"whenToPreferThis":"Use this endpoint when you need to audit or validate the completeness of Hyperliquid liquidation data before querying details, or when diagnosing gaps in historical liquidation records for a specific coin over a defined time window. Prefer this over raw liquidation queries when data quality or coverage verification is the primary goal.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:46:04.666Z","isFirstParty":false}