{"uid":"cap_KnbAxwh7v8vvsFmJ8oawt","slug":"hyperextend-liquidations-history-9ba8df59","name":"Hyperextend Liquidations History","description":"Per-minute Hyperliquid market history: open interest, candles, trades, liquidations, HIP-3, spot and outcome markets. Query any window, pay per request over x402.","url":"https://api.hyperextend.xyz/v1/liquidations/%7Bcoin%7D","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"},"pathParams":{"type":"object","required":["coin"],"properties":{"coin":{"type":"string","description":"Asset symbol, e.g. BTC"}}},"queryParams":{"type":"object","required":[],"properties":{"end":{"type":"integer"},"start":{"type":"integer"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"px":"42000.0","sz":"0.5","dir":"Close Long","tid":859758437920209,"coin":"BTC","hash":"0xa2f9738770fb57c6a473043cd486820204b5006d0bfe769846c21eda2fff31b1","side":"A","time":1700000000123,"users":["0xf513d3489017dea4e04c6a11cc62ec360054d7c6","0xa960b2a0fc5f9f53e99df362052e69980cb57fe4"],"markPx":"41995.0","method":"market","liquidatedUser":"0xa960b2a0fc5f9f53e99df362052e69980cb57fe4"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.006","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.006/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.111","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.111","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_wa1nLdxNeAoC7jEt_ydiI","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.111","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns per-minute historical liquidation events for a given Hyperliquid asset, including price, size, direction, and involved wallet addresses.","exampleAgentPrompt":"Pull the liquidation history for BTC on Hyperliquid between Unix timestamps 1700000000 and 1700086400 — I want to see which positions were closed, at what price, and who got liquidated.","exampleUseCases":null,"resultDescription":"A JSON object containing liquidation event details: the asset coin, execution price, position size, direction (e.g. Close Long), trade ID, transaction hash, side, timestamp in milliseconds, the two involved wallet addresses, mark price at liquidation time, and the specific liquidated user's address.","failureModes":["Invalid or unsupported coin symbol returns an error or empty result","Missing required coin path parameter causes a 400 or 404 response","Start/end timestamps out of available data range return empty results","Payment of 0.111 USDC not fulfilled via x402 protocol results in 402 Payment Required","Rate limiting or server overload may cause 429 or 503 responses","Malformed timestamp integers in query params return validation errors"],"whenToPreferThis":"Choose this endpoint when you need granular, per-minute liquidation event data for a specific Hyperliquid perpetual asset, including the wallet addresses involved and on-chain transaction hashes. Prefer it over generic market data endpoints when the specific use case is tracking forced position closures, monitoring cascade liquidation risk, or auditing specific liquidation events on the Hyperliquid DEX.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:44:08.990Z","isFirstParty":false}