# Order Data This is the order data behind HyperTracker [Market Radar](https://app.coinmarketman.com/hypertracker/market-radar?coin=BTC\&tab=0\&candle=5m\&order=all). It provides exchange-wide access to open orders across Hyperliquid, captured into rolling 5-minute snapshots. Each snapshot separates open orders into stop orders, take profit orders, limit increase orders, and limit reduction orders, allowing builders to study liquidity conditions and track how order clusters form, move, and unwind over time. The public API currently provides 5-minute snapshot data. Real-time order data is available via WebSocket for teams that need lower-latency access. [Contact us](https://t.me/HyperTrackerio) for more info *** ### Get Latest Orders Snapshot Timestamp `/api/external/orders/5m-snapshots/latest-snapshot-timestamp` Returns the timestamp of the most recent 5-minute open orders snapshot. Useful for checking when new snapshot data is available. Use this endpoint to detect when a new snapshot has been published before fetching `/latest`. Request Examples {% tabs %} {% tab title="Curl" %} ``` curl --request GET \ --url 'https://ht-api.coinmarketman.com/api/external/orders/5m-snapshots/latest-snapshot-timestamp' ``` {% endtab %} {% tab title="JavaScript" %} ``` const url = "https://ht-api.coinmarketman.com/api/external/orders/5m-snapshots/latest-snapshot-timestamp"; const res = await fetch(url, { method: "GET" }); const data = await res.json(); console.log(data); ``` {% endtab %} {% tab title="Python" %} ``` import requests response = requests.get( "https://ht-api.coinmarketman.com/api/external/orders/5m-snapshots/latest-snapshot-timestamp", headers={ "Authorization": "Bearer YOUR_API_TOKEN", }, ) result = response.json() ``` {% endtab %} {% endtabs %} Response > **200 Success:** Returns an ISO8601 timestamp for the latest available snapshot.
Response Example ``` "2026-03-25T11:25:00.000Z" ```
*** ### Get Latest Open Orders Snapshot `/api/external/orders/5m-snapshots/latest` {% hint style="success" %} **Unique to HyperTracker Users** Access the latest exchange-wide open order snapshot, refreshed every 5 minutes. Includes every open order across all Hyperliquid markets. {% endhint %} Returns paginated open orders from the latest 5-minute snapshot. By default, this returns all open order types across all markets, which can exceed 350,000 orders. Use filters such as `coin`, `address`, `orderType`, or `oid` to narrow results. Use `nextCursor` to fetch additional pages. Real-time order data is available via WebSocket for teams that need lower-latency access. [Contact us](https://t.me/HyperTrackerio) for more info
Query Parameters
ParameterTypeDescription
limitnumberMaximum number of orders returned per page. Default: 100.
nextCursorstringPagination cursor from the previous response. Use this to fetch the next page.
coinstringFilter by market/coin symbol, e.g. BTC.
addressstringFilter by trader wallet address.
oidstringFilter by a specific order ID. Useful for retrieving one known order.
startstringFilter by order creation time. Returns orders created at or after this ISO8601 timestamp.
endstringFilter by order creation time. Returns orders created at or before this ISO8601 timestamp.
orderTypestringOptional. Filter by order type. If omitted, all order types are returned. Allowed values: Limit, Stop Limit, Stop Market, Take Profit Limit, Take Profit Market.
Request Examples {% tabs %} {% tab title="Curl" %} ``` curl --request GET \ --url 'https://ht-api.coinmarketman.com/api/external/orders/5m-snapshots/latest?limit=100&coin=BTC&orderType=Limit' ``` {% endtab %} {% tab title="JavaScript" %} ``` const url = new URL("https://ht-api.coinmarketman.com/api/external/orders/5m-snapshots/latest"); url.searchParams.set("limit", "100"); url.searchParams.set("coin", "BTC"); url.searchParams.set("orderType", "Limit"); // url.searchParams.set("nextCursor", "YOUR_CURSOR"); // url.searchParams.set("address", "0x..."); // url.searchParams.set("oid", "987654321"); // url.searchParams.set("start", "2026-02-10T11:47:19.099Z"); // url.searchParams.set("end", "2026-02-10T12:47:19.099Z"); const res = await fetch(url.toString(), { method: "GET" }); const data = await res.json(); console.log(data); ``` {% endtab %} {% tab title="Python" %} ``` import requests response = requests.get( "https://ht-api.coinmarketman.com/api/external/orders/5m-snapshots/latest", params={"limit": 50}, headers={ "Authorization": "Bearer YOUR_API_TOKEN", }, ) result = response.json() ``` {% endtab %} {% endtabs %} Response > 200 Success: Returns an `orders` array from the latest 5-minute snapshot, plus `nextCursor` when more results are available. {% hint style="info" %} `snapshotTs` is the timestamp of the 5-minute snapshot the order was captured in.\ `timestamp` is the original order creation timestamp. {% endhint %}
Response Example {% code expandable="true" %} ``` { "orders": [ { "height": 973884953, "address": "0xb12dc7c4ad0160923f0e27b8c2ce43c073257fab", "oid": 1635899387, "coin": "BTC", "side": "A", "limitPx": 23561, "sz": 0.001, "timestamp": "2023-09-29T09:59:26.471Z", "triggerCondition": "Price below 25610", "isTrigger": true, "triggerPx": 25610, "children": [], "isPositionTpsl": false, "reduceOnly": true, "orderType": "Stop Market", "origSz": 0.001, "tif": "", "cloid": "", "status": "open", "builder": "", "builderFee": 0, "untriggered": true, "snapshotTs": "2026-04-26T19:35:00.000Z" }, { "height": 973884953, "address": "0x73fa37fc09d7f58e2cc61fef90827892dd567297", "oid": 2607478808, "coin": "BTC", "side": "A", "limitPx": 2.8, "sz": 0.00034, "timestamp": "2023-11-04T23:08:21.765Z", "triggerCondition": "Price below 3", "isTrigger": true, "triggerPx": 3, "children": [], "isPositionTpsl": false, "reduceOnly": true, "orderType": "Stop Market", "origSz": 0.00034, "tif": "", "cloid": "", "status": "open", "builder": "", "builderFee": 0, "untriggered": true, "snapshotTs": "2026-04-26T19:35:00.000Z" }, { "height": 973884953, "address": "0xf052eb0d59a3979248ea0f6c81e17e047ccf42cf", "oid": 3515918514, "coin": "kBONK", "side": "A", "limitPx": 0.002845, "sz": 78486, "timestamp": "2023-11-22T14:58:34.256Z", "triggerCondition": "Price below 0.003092", "isTrigger": true, "triggerPx": 0.003092, "children": [], "isPositionTpsl": false, "reduceOnly": true, "orderType": "Stop Market", "origSz": 78486, "tif": "", "cloid": "", "status": "open", "builder": "", "builderFee": 0, "untriggered": true, "snapshotTs": "2026-04-26T19:35:00.000Z" }, { "height": 973884953, "address": "0x5dff41f51143f2baf11eb9c22065cf3a0d64e727", "oid": 6438299560, "coin": "ETH", "side": "A", "limitPx": 920, "sz": 0, "timestamp": "2024-01-07T16:46:13.161Z", "triggerCondition": "Price below 1000", "isTrigger": true, "triggerPx": 1000, "children": [], "isPositionTpsl": true, "reduceOnly": true, "orderType": "Stop Market", "origSz": 0, "tif": "", "cloid": "", "status": "open", "builder": "", "builderFee": 0, "untriggered": true, "snapshotTs": "2026-04-26T19:35:00.000Z" }, { "height": 973884953, "address": "0xc1518eadd8d9e9f14e0e34b75575f21ff3a80200", "oid": 7810544077, "coin": "BTC", "side": "A", "limitPx": 27683, "sz": 0.0108, "timestamp": "2024-01-23T02:06:22.771Z", "triggerCondition": "Price below 30090", "isTrigger": true, "triggerPx": 30090, "children": [], "isPositionTpsl": false, "reduceOnly": true, "orderType": "Stop Market", "origSz": 0.0108, "tif": "", "cloid": "", "status": "open", "builder": "", "builderFee": 0, "untriggered": true, "snapshotTs": "2026-04-26T19:35:00.000Z" }, { "height": 973884953, "address": "0x1854e0970b9cb653cd5c7eb932aa7db43ca2a30d", "oid": 8922633698, "coin": "BTC", "side": "A", "limitPx": 37904, "sz": 0.06212, "timestamp": "2024-02-06T06:05:32.891Z", "triggerCondition": "Price below 41200", "isTrigger": true, "triggerPx": 41200, "children": [], "isPositionTpsl": false, "reduceOnly": true, "orderType": "Stop Market", "origSz": 0.06212, "tif": "", "cloid": "", "status": "open", "builder": "", "builderFee": 0, "untriggered": true, "snapshotTs": "2026-04-26T19:35:00.000Z" }, { "height": 973884953, "address": "0xd3caded56f20c91d98bf72b66d487c19769b58d7", "oid": 9744556488, "coin": "BNB", "side": "A", "limitPx": 339.21, "sz": 0.266, "timestamp": "2024-02-15T14:24:08.251Z", "triggerCondition": "Price below 339.21", "isTrigger": true, "triggerPx": 339.21, "children": [], "isPositionTpsl": false, "reduceOnly": true, "orderType": "Stop Market", "origSz": 0.266, "tif": "", "cloid": "", "status": "open", "builder": "", "builderFee": 0, "untriggered": true, "snapshotTs": "2026-04-26T19:35:00.000Z" }, { "height": 973884953, "address": "0xc47035a1bd4fd9df31a2795e87b288512bb524d8", "oid": 9748098932, "coin": "BNB", "side": "A", "limitPx": 344.57, "sz": 0.316, "timestamp": "2024-02-15T14:56:58.134Z", "triggerCondition": "Price below 344.57", "isTrigger": true, "triggerPx": 344.57, "children": [], "isPositionTpsl": false, "reduceOnly": true, "orderType": "Stop Market", "origSz": 0.316, "tif": "", "cloid": "", "status": "open", "builder": "", "builderFee": 0, "untriggered": true, "snapshotTs": "2026-04-26T19:35:00.000Z" }, { "height": 973884953, "address": "0x5822f06f037a371697705e04575c374aa961fbb5", "oid": 9907667795, "coin": "TIA", "side": "B", "limitPx": 21.751, "sz": 94.3, "timestamp": "2024-02-17T00:30:25.019Z", "triggerCondition": "Price above 20.14", "isTrigger": true, "triggerPx": 20.14, "children": [], "isPositionTpsl": false, "reduceOnly": false, "orderType": "Stop Market", "origSz": 94.3, "tif": "", "cloid": "", "status": "open", "builder": "", "builderFee": 0, "untriggered": true, "snapshotTs": "2026-04-26T19:35:00.000Z" }, { "height": 973884953, "address": "0x5822f06f037a371697705e04575c374aa961fbb5", "oid": 11513968046, "coin": "ZETA", "side": "B", "limitPx": 2.9268, "sz": 664, "timestamp": "2024-03-01T11:05:51.161Z", "triggerCondition": "Price above 2.71", "isTrigger": true, "triggerPx": 2.71, "children": [], "isPositionTpsl": false, "reduceOnly": false, "orderType": "Stop Market", "origSz": 664, "tif": "", "cloid": "", "status": "open", "builder": "", "builderFee": 0, "untriggered": true, "snapshotTs": "2026-04-26T19:35:00.000Z" } ], "nextCursor": "eyJ0aW1lc3RhbXAiOjE3MDkyOTExNTExNjEsIm9pZCI6MTE1MTM5NjgwNDYsImFkZHJlc3MiOiIweDU4MjJmMDZmMDM3YTM3MTY5NzcwNWUwNDU3NWMzNzRhYTk2MWZiYjUifQ.wtHt7c-bRnlFEEK2OY5AILme2nIhaCkYD1djK-x96XA" } ``` {% endcode %}
*** ### Get Orders Snapshot by Timestamp `/api/external/orders/5m-snapshots/{snapshotTime}` {% hint style="success" %} **Unique to HyperTracker Users** Provides full exchange-wide open order snapshots at fixed 5-minute intervals, reconstructed and stored by HyperTracker. This historical dataset is not available via the standard Hyperliquid API. {% endhint %} Returns a paginated list of all open orders captured at a specific 5-minute snapshot in time. Unlike `/latest`, this endpoint allows you to query historical snapshots within a rolling 30-day window. Each snapshot represents a complete point-in-time view of the exchange’s open order book. #### **The `snapshotTime` must:** * Be aligned to a 5-minute boundary (e.g. 11:05, 11:10, 11:15) * Be within the last 30 days * Not be in the future Snapshots are retained for 30 days. Results can be filtered by market (`coin`), address, order ID, time range, and order type. Use `nextCursor` to paginate through large snapshots. Each response reflects the exact state of all open orders at the snapshot timestamp, regardless of when the orders were originally placed. Large snapshots may contain hundreds of thousands of orders. Pagination via `nextCursor` is required to retrieve the full dataset.
Query Parameters
ParameterTypeDescription
snapshotTimestringSnapshot timestamp (path). Must align to a 5-minute interval and fall within the last 30 days.
limitnumberLimit number of results returned. Default value: 100.
nextCursorstringPagination cursor returned by the previous response. Provide this to continue fetching the next page of results.
coinstringMarket identifier (coin symbol) to filter orders by, for example BTC.
addressstringTrader account address to filter orders by.
oidstringFilter by a specific order ID. Useful when you want to retrieve one known order from the snapshot.
startstringFilter orders created at or after this timestamp (ISO8601).
endstringFilter orders created at or before this timestamp (ISO8601).
orderTypestringRestrict results to a specific order type. If omitted, all order types are returned.
Allowed values: Limit, Stop Limit, Stop Market, Take Profit Limit, Take Profit Market.
Request Examples {% tabs %} {% tab title="Curl" %} ``` curl --request GET \ --url 'https://ht-api.coinmarketman.com/api/external/orders/5m-snapshots/2026-04-19T11:05:00Z?coin=BTC&limit=100' \ --header 'Authorization: Bearer YOUR_API_KEY' ``` {% endtab %} {% tab title="JavaScript" %} ``` const snapshotTime = "2026-01-19T11:05:00+00:00"; const url = new URL( `https://ht-api.coinmarketman.com/api/external/orders/5m-snapshots/${encodeURIComponent(snapshotTime)}` ); url.searchParams.set("limit", "100"); url.searchParams.set("coin", "BTC"); // url.searchParams.set("nextCursor", "YOUR_CURSOR"); // url.searchParams.set("address", "0x..."); // url.searchParams.set("oid", "987654321"); // url.searchParams.set("start", "2026-02-10T11:00:00.000Z"); // url.searchParams.set("end", "2026-02-10T12:00:00.000Z"); // url.searchParams.set("orderType", "Limit"); const res = await fetch(url.toString(), { method: "GET" }); const data = await res.json(); console.log(data); ``` {% endtab %} {% tab title="Python" %} ``` import requests snapshot_time = "2026-01-19T11:05:00+00:00" response = requests.get( f"https://ht-api.coinmarketman.com/api/external/orders/5m-snapshots/{snapshot_time}", headers={ "Authorization": "Bearer YOUR_API_TOKEN", }, ) result = response.json() ``` {% endtab %} {% endtabs %} Response > **200 Success:** Returns a JSON payload containing an `orders` array representing open orders at the requested snapshot, plus `nextCursor` when additional results are available.
Response Example {% code expandable="true" %} ``` { "orders": [ { "height": 964633454, "address": "0xdef1b00b0fffeda0bf2f1adc3cd0ed4ec12c5e93", "oid": 756322353, "coin": "BTC", "side": "B", "limitPx": 21500, "sz": 0.00465, "timestamp": "2023-07-18T10:30:51.626Z", "triggerCondition": "N/A", "isTrigger": false, "triggerPx": 0, "children": [], "isPositionTpsl": false, "reduceOnly": false, "orderType": "Limit", "origSz": 0, "tif": "", "cloid": "", "status": "open", "builder": "", "builderFee": 0, "untriggered": false, "snapshotTs": "2026-04-19T11:05:00.000Z" }, { "height": 964633454, "address": "0x42ff1c2d4794a00b67e2da9e5cf3d06432ef7bb3", "oid": 1164652284, "coin": "BTC", "side": "B", "limitPx": 24206, "sz": 0.02522, "timestamp": "2023-08-22T16:48:54.365Z", "triggerCondition": "N/A", "isTrigger": false, "triggerPx": 0, "children": [], "isPositionTpsl": false, "reduceOnly": false, "orderType": "Limit", "origSz": 0.02522, "tif": "", "cloid": "", "status": "open", "builder": "", "builderFee": 0, "untriggered": false, "snapshotTs": "2026-04-19T11:05:00.000Z" }, { "height": 964633454, "address": "0xb12dc7c4ad0160923f0e27b8c2ce43c073257fab", "oid": 1635899386, "coin": "BTC", "side": "B", "limitPx": 25900, "sz": 0.001, "timestamp": "2023-09-29T09:59:26.471Z", "triggerCondition": "N/A", "isTrigger": false, "triggerPx": 0, "children": [ { "sz": 0.001, "oid": 1635899387, "tif": "", "coin": "BTC", "side": "A", "cloid": "", "height": 964633454, "origSz": 0.001, "status": "open", "address": "0xb12dc7c4ad0160923f0e27b8c2ce43c073257fab", "builder": "", "limitPx": 23561, "children": [], "isTrigger": true, "orderType": "Stop Market", "timestamp": 1695981566471, "triggerPx": 25610, "builderFee": 0, "reduceOnly": true, "untriggered": false, "snapshotTime": 1776596700000, "isPositionTpsl": false, "triggerCondition": "Price below 25610" }, { "sz": 0.001, "oid": 1635899388, "tif": "", "coin": "BTC", "side": "A", "cloid": "", "height": 964633454, "origSz": 0.001, "status": "open", "address": "0xb12dc7c4ad0160923f0e27b8c2ce43c073257fab", "builder": "", "limitPx": 25120, "children": [], "isTrigger": true, "orderType": "Take Profit Market", "timestamp": 1695981566471, "triggerPx": 27304, "builderFee": 0, "reduceOnly": true, "untriggered": false, "snapshotTime": 1776596700000, "isPositionTpsl": false, "triggerCondition": "Price above 27304" } ], "isPositionTpsl": false, "reduceOnly": false, "orderType": "Limit", "origSz": 0.001, "tif": "Gtc", "cloid": "", "status": "open", "builder": "", "builderFee": 0, "untriggered": false, "snapshotTs": "2026-04-19T11:05:00.000Z" }, { "height": 964633454, "address": "0xb12dc7c4ad0160923f0e27b8c2ce43c073257fab", "oid": 1635899387, "coin": "BTC", "side": "A", "limitPx": 23561, "sz": 0.001, "timestamp": "2023-09-29T09:59:26.471Z", "triggerCondition": "Price below 25610", "isTrigger": true, "triggerPx": 25610, "children": [], "isPositionTpsl": false, "reduceOnly": true, "orderType": "Stop Market", "origSz": 0.001, "tif": "", "cloid": "", "status": "open", "builder": "", "builderFee": 0, "untriggered": true, "snapshotTs": "2026-04-19T11:05:00.000Z" }, { "height": 964633454, "address": "0xb12dc7c4ad0160923f0e27b8c2ce43c073257fab", "oid": 1635899388, "coin": "BTC", "side": "A", "limitPx": 25120, "sz": 0.001, "timestamp": "2023-09-29T09:59:26.471Z", "triggerCondition": "Price above 27304", "isTrigger": true, "triggerPx": 27304, "children": [], "isPositionTpsl": false, "reduceOnly": true, "orderType": "Take Profit Market", "origSz": 0.001, "tif": "", "cloid": "", "status": "open", "builder": "", "builderFee": 0, "untriggered": true, "snapshotTs": "2026-04-19T11:05:00.000Z" }, { "height": 964633454, "address": "0xddb71f7aaa7ed320f7fb30964a3d80cb08e13d6f", "oid": 2038956130, "coin": "BTC", "side": "B", "limitPx": 27700, "sz": 0.19034, "timestamp": "2023-10-20T22:31:04.532Z", "triggerCondition": "N/A", "isTrigger": false, "triggerPx": 0, "children": [], "isPositionTpsl": false, "reduceOnly": false, "orderType": "Limit", "origSz": 0.19034, "tif": "Gtc", "cloid": "", "status": "open", "builder": "", "builderFee": 0, "untriggered": false, "snapshotTs": "2026-04-19T11:05:00.000Z" }, { "height": 964633454, "address": "0x73fa37fc09d7f58e2cc61fef90827892dd567297", "oid": 2607478808, "coin": "BTC", "side": "A", "limitPx": 2.8, "sz": 0.00034, "timestamp": "2023-11-04T23:08:21.765Z", "triggerCondition": "Price below 3", "isTrigger": true, "triggerPx": 3, "children": [], "isPositionTpsl": false, "reduceOnly": true, "orderType": "Stop Market", "origSz": 0.00034, "tif": "", "cloid": "", "status": "open", "builder": "", "builderFee": 0, "untriggered": true, "snapshotTs": "2026-04-19T11:05:00.000Z" }, { "height": 964633454, "address": "0xd703d828fd9212db0b716760dbaf2899d811cacb", "oid": 2718532555, "coin": "SOL", "side": "B", "limitPx": 38.6, "sz": 10.12, "timestamp": "2023-11-07T17:52:10.281Z", "triggerCondition": "N/A", "isTrigger": false, "triggerPx": 0, "children": [], "isPositionTpsl": false, "reduceOnly": false, "orderType": "Limit", "origSz": 10.12, "tif": "Gtc", "cloid": "", "status": "open", "builder": "", "builderFee": 0, "untriggered": false, "snapshotTs": "2026-04-19T11:05:00.000Z" }, { "height": 964633454, "address": "0xb46b55974e86e613a9341917e6cc2059b4e29480", "oid": 2797727005, "coin": "SOL", "side": "B", "limitPx": 42.667, "sz": 2.58, "timestamp": "2023-11-09T16:20:58.394Z", "triggerCondition": "N/A", "isTrigger": false, "triggerPx": 0, "children": [], "isPositionTpsl": false, "reduceOnly": false, "orderType": "Limit", "origSz": 2.58, "tif": "Gtc", "cloid": "", "status": "open", "builder": "", "builderFee": 0, "untriggered": false, "snapshotTs": "2026-04-19T11:05:00.000Z" }, { "height": 964633454, "address": "0xb46b55974e86e613a9341917e6cc2059b4e29480", "oid": 2797727006, "coin": "SOL", "side": "B", "limitPx": 42, "sz": 2.58, "timestamp": "2023-11-09T16:20:58.394Z", "triggerCondition": "N/A", "isTrigger": false, "triggerPx": 0, "children": [], "isPositionTpsl": false, "reduceOnly": false, "orderType": "Limit", "origSz": 2.58, "tif": "Gtc", "cloid": "", "status": "open", "builder": "", "builderFee": 0, "untriggered": false, "snapshotTs": "2026-04-19T11:05:00.000Z" } ], "nextCursor": "eyJ0aW1lc3RhbXAiOjE2OTk1NDY4NTgzOTQsIm9pZCI6Mjc5NzcyNzAwNiwiYWRkcmVzcyI6IjB4YjQ2YjU1OTc0ZTg2ZTYxM2E5MzQxOTE3ZTZjYzIwNTliNGUyOTQ4MCJ9.En6KkpUlS9oXz8_aOPVvX2Y_6flJ2HnZHzGUi4bWyOg" } ``` {% endcode %}
*** ### Export Orders Snapshot by Timestamp `/api/external/orders/5m-snapshots/{snapshotTime}/download` {% hint style="success" %} **Unique to HyperTracker Users** Provides downloadable access to full exchange-wide open order snapshots at fixed 5-minute intervals, reconstructed and stored by HyperTracker. This historical dataset is not available via the standard Hyperliquid API. {% endhint %} Returns a download URL for the complete 5-minute open orders snapshot at the specified `snapshotTime`. This endpoint is functionally similar to the paginated snapshot endpoint, but instead of returning paginated JSON, it provides a single export file containing the full dataset. Use this when you need the entire snapshot in one request (e.g. for offline processing, bulk analysis, or storage). Unlike the paginated snapshot endpoint, this export endpoint provides access to historical snapshots dating back to **2026-01-19T11:05:00+00:00**. #### **The `snapshotTime` must:** * Be aligned to a 5-minute boundary (e.g. 11:05, 11:10, 11:15) * Be on or after `2026-01-19T11:05:00+00:00` * Not be in the future
Query Parameters
ParameterTypeDescription
snapshotTimestringSnapshot timestamp (path). Must be a multiple of 5 minutes, must be >= 2026-01-19T11:05:00+00:00and cannot be in the future.
Request Examples {% tabs %} {% tab title="Curl" %} ``` curl --request GET \ --url 'https://ht-api.coinmarketman.com/api/external/orders/5m-snapshots/2026-01-19T11:05:00+00:00/download' ``` {% endtab %} {% tab title="JavaScript" %} ``` const snapshotTime = "2026-01-19T11:05:00+00:00"; const url = `https://ht-api.coinmarketman.com/api/external/orders/5m-snapshots/${encodeURIComponent(snapshotTime)}/download`; const res = await fetch(url, { method: "GET" }); const data = await res.json(); console.log(data); ``` {% endtab %} {% tab title="Python" %} ``` import requests snapshot_time = "2026-01-19T11:05:00+00:00" response = requests.get( f"https://ht-api.coinmarketman.com/api/external/orders/5m-snapshots/{snapshot_time}/download", headers={ "Authorization": "Bearer YOUR_API_TOKEN", }, ) result = response.json() ``` {% endtab %} {% endtabs %} Response > **200 Success:** Returns a JSON object containing a `downloadUrl` pointing to the snapshot file. > > The downloaded file contains the full, unpaginated dataset of all open orders at the requested snapshot timestamp.
Response Example {% code expandable="true" %} ``` { "metrics": [ { "snapshotTime": 1770721500000, "timestamp": 1770721498032, "height": 889785009, "address": "0x727956612a8700627451204a3ae26268bd1a1525", "coin": "0G", "side": "B", "limitPx": 0.52915, "sz": 247, "oid": 317315441547, "triggerCondition": "N/A", "isTrigger": false, "triggerPx": 0, "children": [], "isPositionTpsl": false, "reduceOnly": false, "orderType": "Limit", "origSz": 247, "tif": "Alo", "cloid": "0x00000000000000000000019c46f2ae94", "status": "open", "builder": "", "builderFee": 0, "untriggered": false }, { "snapshotTime": 1770721500000, "timestamp": 1770721497697, "height": 889785009, "address": "0x31ca8395cf837de08b24da3f660e77761dfb974b", "coin": "0G", "side": "B", "limitPx": 0.52914, "sz": 1250, "oid": 317315439569, "triggerCondition": "N/A", "isTrigger": false, "triggerPx": 0, "children": [], "isPositionTpsl": false, "reduceOnly": false, "orderType": "Limit", "origSz": 1250, "tif": "Alo", "cloid": "", "status": "open", "builder": "", "builderFee": 0, "untriggered": false }, { "snapshotTime": 1770721500000, "timestamp": 1770721497548, "height": 889785009, "address": "0x010461c14e146ac35fe42271bdc1134ee31c703a", "coin": "0G", "side": "B", "limitPx": 0.5291, "sz": 1188, "oid": 317315439129, "triggerCondition": "N/A", "isTrigger": false, "triggerPx": 0, "children": [], "isPositionTpsl": false, "reduceOnly": false, "orderType": "Limit", "origSz": 1188, "tif": "Alo", "cloid": "", "status": "open", "builder": "", "builderFee": 0, "untriggered": false }, { "snapshotTime": 1770721500000, "timestamp": 1770721497401, "height": 889785009, "address": "0x6b8c9c4e9d52a2b6e7a4f07dfb6b0fd7d5fd2d5c", "coin": "0G", "side": "B", "limitPx": 0.52909, "sz": 500, "oid": 317315438701, "triggerCondition": "N/A", "isTrigger": false, "triggerPx": 0, "children": [], "isPositionTpsl": false, "reduceOnly": false, "orderType": "Limit", "origSz": 500, "tif": "Alo", "cloid": "", "status": "open", "builder": "", "builderFee": 0, "untriggered": false }, { "snapshotTime": 1770721500000, "timestamp": 1770721497265, "height": 889785009, "address": "0x9f2b3b9e2c1a8c4f1b6d9e3a7a5c2b1e8d4c6f7a", "coin": "0G", "side": "B", "limitPx": 0.52908, "sz": 320, "oid": 317315438295, "triggerCondition": "N/A", "isTrigger": false, "triggerPx": 0, "children": [], "isPositionTpsl": false, "reduceOnly": false, "orderType": "Limit", "origSz": 320, "tif": "Alo", "cloid": "", "status": "open", "builder": "", "builderFee": 0, "untriggered": false } ], "nextCursor": "BEARER_KEY" } ``` {% endcode %}
*** ### Export Latest Orders Snapshot by Coin `/api/external/orders/5m-snapshots/coins/{coin}/download` {% hint style="success" %} **Unique to HyperTracker Users** Provides downloadable access to the latest exchange-wide open order snapshot for a specific market (coin), reconstructed and delivered by HyperTracker. This data is not available in this format via the standard Hyperliquid API. {% endhint %} Returns a download URL for the **latest 5-minute open orders snapshot** for a specific coin. This endpoint is functionally equivalent to the “latest snapshot by coin” API, but instead of returning paginated JSON, it provides a **single export file** containing the full dataset for that coin at the most recent snapshot. Use this when you want the complete dataset in one request (e.g. bulk analysis, storage, or offline processing) rather than iterating through paginated results.
Query Parameters
ParameterTypeDescription
coinstringMarket identifier (coin symbol) to fetch the latest snapshot for (path parameter), e.g. BTC, SOL.
Request Examples {% tabs %} {% tab title="Curl" %} ``` curl --request GET \ --url 'https://ht-api.coinmarketman.com/api/external/orders/5m-snapshots/coins/btc/download' ``` {% endtab %} {% tab title="JavaScript" %} ``` const coin = "btc"; const url = `https://ht-api.coinmarketman.com/api/external/orders/5m-snapshots/coins/${encodeURIComponent(coin)}/download`; const res = await fetch(url, { method: "GET" }); const data = await res.json(); console.log(data); ``` {% endtab %} {% tab title="Python" %} ``` import requests coin = "btc" response = requests.get( f"https://ht-api.coinmarketman.com/api/external/orders/5m-snapshots/coins/{coin}/download", headers={ "Authorization": "Bearer YOUR_API_TOKEN", }, ) result = response.json() ``` {% endtab %} {% endtabs %} Response > 200 Success: Returns a JSON object containing a `downloadUrl`.
Response Example {% code expandable="true" %} ``` { "metrics": [ { "snapshotTime": 1774439700000, "timestamp": 1774439699078, "height": 934839110, "address": "0x5eaac7c475b1fad85701f02c4e9e796a53f94bd5", "coin": "BTC", "side": "B", "limitPx": 71609, "sz": 0.72199, "oid": 360842116299, "triggerCondition": "N/A", "isTrigger": false, "triggerPx": 0, "children": [], "isPositionTpsl": false, "reduceOnly": false, "orderType": "Limit", "origSz": 0.77607, "tif": "Alo", "cloid": "0x0000000004fdca1a000036ca83c51c39", "status": "open", "builder": "", "builderFee": 0, "untriggered": false }, { "snapshotTime": 1774439700000, "timestamp": 1774439699078, "height": 934839110, "address": "0x3ac9b030594c1ef23a3e8fed9f62356b7bf98bf6", "coin": "BTC", "side": "B", "limitPx": 71609, "sz": 0.385, "oid": 360842116304, "triggerCondition": "N/A", "isTrigger": false, "triggerPx": 0, "children": [], "isPositionTpsl": false, "reduceOnly": false, "orderType": "Limit", "origSz": 0.385, "tif": "Alo", "cloid": "0x00000000062e81c3000014e183101c7a", "status": "open", "builder": "", "builderFee": 0, "untriggered": false }, { "snapshotTime": 1774439700000, "timestamp": 1774439699078, "height": 934839110, "address": "0xaf2ac71f62f341e5823d6985492409e92c940447", "coin": "BTC", "side": "B", "limitPx": 71609, "sz": 0.385, "oid": 360842116356, "triggerCondition": "N/A", "isTrigger": false, "triggerPx": 0, "children": [], "isPositionTpsl": false, "reduceOnly": false, "orderType": "Limit", "origSz": 0.385, "tif": "Alo", "cloid": "0x00000000090f312b00001487e12b1c22", "status": "open", "builder": "", "builderFee": 0, "untriggered": false }, { "snapshotTime": 1774439700000, "timestamp": 1774439699078, "height": 934839110, "address": "0x362c5006ed0a405c35df4a138cb38d891f1a1a20", "coin": "BTC", "side": "B", "limitPx": 71609, "sz": 0.385, "oid": 360842116410, "triggerCondition": "N/A", "isTrigger": false, "triggerPx": 0, "children": [], "isPositionTpsl": false, "reduceOnly": false, "orderType": "Limit", "origSz": 0.385, "tif": "Alo", "cloid": "0x00000000049ea9e600002a621ce91c8d", "status": "open", "builder": "", "builderFee": 0, "untriggered": false }, { "snapshotTime": 1774439700000, "timestamp": 1774439699078, "height": 934839110, "address": "0xc8264ebc379e26946e7d31ae4746c27182849755", "coin": "BTC", "side": "B", "limitPx": 71609, "sz": 0.24462, "oid": 360842116444, "triggerCondition": "N/A", "isTrigger": false, "triggerPx": 0, "children": [], "isPositionTpsl": false, "reduceOnly": false, "orderType": "Limit", "origSz": 0.24462, "tif": "Alo", "cloid": "0x00000000000000000000019d0d540d04", "status": "open", "builder": "", "builderFee": 0, "untriggered": false }, { "snapshotTime": 1774439700000, "timestamp": 1774439699078, "height": 934839110, "address": "0xf8c5362479968e9b9643c9f3b93fbaf3db008acd", "coin": "BTC", "side": "B", "limitPx": 71609, "sz": 0.5, "oid": 360842116478, "triggerCondition": "N/A", "isTrigger": false, "triggerPx": 0, "children": [], "isPositionTpsl": false, "reduceOnly": false, "orderType": "Limit", "origSz": 0.5, "tif": "Alo", "cloid": "0x000000000037ecec00000e2918c71c9d", "status": "open", "builder": "", "builderFee": 0, "untriggered": false }, { "snapshotTime": 1774439700000, "timestamp": 1774439699078, "height": 934839110, "address": "0x5bcbbb10358ddb623593e51f499568ea54c2aeed", "coin": "BTC", "side": "B", "limitPx": 71609, "sz": 0.25034, "oid": 360842116487, "triggerCondition": "N/A", "isTrigger": false, "triggerPx": 0, "children": [], "isPositionTpsl": false, "reduceOnly": false, "orderType": "Limit", "origSz": 0.25034, "tif": "Alo", "cloid": "0x000000000d0e8e490000342bc6971c2f", "status": "open", "builder": "", "builderFee": 0, "untriggered": false }, { "snapshotTime": 1774439700000, "timestamp": 1774439699078, "height": 934839110, "address": "0xfcf104006bfff47695c1dc21dad3e9de1e72098e", "coin": "BTC", "side": "B", "limitPx": 71609, "sz": 0.17599, "oid": 360842116533, "triggerCondition": "N/A", "isTrigger": false, "triggerPx": 0, "children": [], "isPositionTpsl": false, "reduceOnly": false, "orderType": "Limit", "origSz": 0.17599, "tif": "Alo", "cloid": "0x00000000000000000000019d24b578c9", "status": "open", "builder": "", "builderFee": 0, "untriggered": false }, { "snapshotTime": 1774439700000, "timestamp": 1774439699078, "height": 934839110, "address": "0x50d59f4c2480e107acf32c0d1e9cbe7579b01480", "coin": "BTC", "side": "B", "limitPx": 71609, "sz": 0.35, "oid": 360842116536, "triggerCondition": "N/A", "isTrigger": false, "triggerPx": 0, "children": [], "isPositionTpsl": false, "reduceOnly": false, "orderType": "Limit", "origSz": 0.35, "tif": "Alo", "cloid": "0x00000000028085d1000006eeb99e1c23", "status": "open", "builder": "", "builderFee": 0, "untriggered": false }, { "snapshotTime": 1774439700000, "timestamp": 1774439699078, "height": 934839110, "address": "0x13558be785661958932ceac35ba20de187275a42", "coin": "BTC", "side": "B", "limitPx": 71609, "sz": 0.72515, "oid": 360842116568, "triggerCondition": "N/A", "isTrigger": false, "triggerPx": 0, "children": [], "isPositionTpsl": false, "reduceOnly": false, "orderType": "Limit", "origSz": 0.72515, "tif": "Alo", "cloid": "0x00000000067a860a00002cc94ded1c90", "status": "open", "builder": "", "builderFee": 0, "untriggered": false }, { "snapshotTime": 1774439700000, "timestamp": 1774439699078, "height": 934839110, "address": "0xe92cdf7b804a836a71219cda2b00274d57ac030f", "coin": "BTC", "side": "B", "limitPx": 71609, "sz": 0.27011, "oid": 360842116660, "triggerCondition": "N/A", "isTrigger": false, "triggerPx": 0, "children": [], "isPositionTpsl": false, "reduceOnly": false, "orderType": "Limit", "origSz": 0.27011, "tif": "Alo", "cloid": "0x000000000000000000064dd7efe88d08", "status": "open", "builder": "", "builderFee": 0, "untriggered": false }, { "snapshotTime": 1774439700000, "timestamp": 1774439699078, "height": 934839110, "address": "0xb756c89e73c8711a881c009e10f79b1566f80cdb", "coin": "BTC", "side": "B", "limitPx": 71609, "sz": 1.31831, "oid": 360842116725, "triggerCondition": "N/A", "isTrigger": false, "triggerPx": 0, "children": [], "isPositionTpsl": false, "reduceOnly": false, "orderType": "Limit", "origSz": 1.31831, "tif": "Alo", "cloid": "0x95fe600e394675ce3c8efa2bf6949202", "status": "open", "builder": "", "builderFee": 0, "untriggered": false }, { "snapshotTime": 1774439700000, "timestamp": 1774439699078, "height": 934839110, "address": "0xe3b3482482899b4890ec5a2093cba2a558d0c14f", "coin": "BTC", "side": "B", "limitPx": 71609, "sz": 0.03193, "oid": 360842116966, "triggerCondition": "N/A", "isTrigger": false, "triggerPx": 0, "children": [], "isPositionTpsl": false, "reduceOnly": false, "orderType": "Limit", "origSz": 0.03193, "tif": "Alo", "cloid": "0x000000000fe3b724000008245f751c31", "status": "open", "builder": "", "builderFee": 0, "untriggered": false }, { "snapshotTime": 1774439700000, "timestamp": 1774439699078, "height": 934839110, "address": "0xb6bfa5b79c1f06d5cf21d21e00f25d8da9fcfdb1", "coin": "BTC", "side": "B", "limitPx": 71609, "sz": 0.10469, "oid": 360842117005, "triggerCondition": "N/A", "isTrigger": false, "triggerPx": 0, "children": [], "isPositionTpsl": false, "reduceOnly": false, "orderType": "Limit", "origSz": 0.10469, "tif": "Alo", "cloid": "0xb6bfa5b79c1f06d50001f6277eb5b652", "status": "open", "builder": "", "builderFee": 0, "untriggered": false }, { "snapshotTime": 1774439700000, "timestamp": 1774439699078, "height": 934839110, "address": "0xf5d81a135f756ca16544e53c20fc20643ec3ad53", "coin": "BTC", "side": "B", "limitPx": 71609, "sz": 0.025, "oid": 360842117100, "triggerCondition": "N/A", "isTrigger": false, "triggerPx": 0, "children": [], "isPositionTpsl": false, "reduceOnly": false, "orderType": "Limit", "origSz": 0.025, "tif": "Alo", "cloid": "0x3fcb33a372aace3364ca733844e96364", "status": "open", "builder": "", "builderFee": 0, "untriggered": false }, { "snapshotTime": 1774439700000, "timestamp": 1774439699078, "height": 934839110, "address": "0x1a2e6afa298b1cc50939b4b2b0b430e3c1ef3459", "coin": "BTC", "side": "B", "limitPx": 71609, "sz": 0.77, "oid": 360842117156, "triggerCondition": "N/A", "isTrigger": false, "triggerPx": 0, "children": [], "isPositionTpsl": false, "reduceOnly": false, "orderType": "Limit", "origSz": 0.77, "tif": "Alo", "cloid": "0x00000000075becdf0000199c66961c7c", "status": "open", "builder": "", "builderFee": 0, "untriggered": false }, { "snapshotTime": 1774439700000, "timestamp": 1774439699078, "height": 934839110, "address": "0xbb160cb61e694570f9d570f9fcde7c61dd2143ad", "coin": "BTC", "side": "B", "limitPx": 71609, "sz": 0.12026, "oid": 360842117160, "triggerCondition": "N/A", "isTrigger": false, "triggerPx": 0, "children": [], "isPositionTpsl": false, "reduceOnly": false, "orderType": "Limit", "origSz": 0.12026, "tif": "Alo", "cloid": "0x00000000000000000000019d24b2e2e6", "status": "open", "builder": "", "builderFee": 0, "untriggered": false }, { "snapshotTime": 1774439700000, "timestamp": 1774439699078, "height": 934839110, "address": "0x925a3877cd884b8edf3160192f76c7c251f83856", "coin": "BTC", "side": "B", "limitPx": 71609, "sz": 0.72496, "oid": 360842117299, "triggerCondition": "N/A", "isTrigger": false, "triggerPx": 0, "children": [], "isPositionTpsl": false, "reduceOnly": false, "orderType": "Limit", "origSz": 0.72496, "tif": "Alo", "cloid": "0x0000000003b0476300000aa911151c46", "status": "open", "builder": "", "builderFee": 0, "untriggered": false }, { "snapshotTime": 1774439700000, "timestamp": 1774439699078, "height": 934839110, "address": "0xbe1f79b4ca0a09fdd71e0055b8e062ea82ad315d", "coin": "BTC", "side": "B", "limitPx": 71609, "sz": 0.23542, "oid": 360842117306, "triggerCondition": "N/A", "isTrigger": false, "triggerPx": 0, "children": [], "isPositionTpsl": false, "reduceOnly": false, "orderType": "Limit", "origSz": 0.23542, "tif": "Alo", "cloid": "0x00000000000000000000019d0d4c5e6a", "status": "open", "builder": "", "builderFee": 0, "untriggered": false }, { "snapshotTime": 1774439700000, "timestamp": 1774439699078, "height": 934839110, "address": "0xf58b673c1633ccef0ac58263cdc95ed80f817fc7", "coin": "BTC", "side": "B", "limitPx": 71609, "sz": 0.12, "oid": 360842117538, "triggerCondition": "N/A", "isTrigger": false, "triggerPx": 0, "children": [], "isPositionTpsl": false, "reduceOnly": false, "orderType": "Limit", "origSz": 0.12, "tif": "Alo", "cloid": "0x8af5a4779b38445ea66b82cc157c2013", "status": "open", "builder": "", "builderFee": 0, "untriggered": false } ], "nextCursor": "BEARER_KEY" } ``` {% endcode %}
--- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.coinmarketman.com/endpoints/order-data.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.