{ "x402Version": 2, "id": 1455, "slug": "1455", "resource": "https://omniterminal.app/api/x402/v1/liquidations/:symbol", "description": "Omni Terminal finds where forced-liquidation pressure is concentrated using all bounded published Hyperliquid levels anchored to live mark price, explicit position-side versus liquidation-flow semantics, margin-stress scenarios, and a selected summary, heatmap, cluster, or flow view.", "type": "http", "accepts": [ { "scheme": "exact", "network": "eip155:84532", "payTo": "0x733f40A4FA0cd13d59aBADE04b9eD2e9acAc6457", "asset": "0x036CbD53842c5426634e7929541eC2318f3dCF7e", "amount": "5000", "maxTimeoutSeconds": 300 }, { "scheme": "exact", "network": "eip155:8453", "payTo": "0x733f40A4FA0cd13d59aBADE04b9eD2e9acAc6457", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "amount": "5000", "maxTimeoutSeconds": 300 } ], "outputSchema": { "bazaar": { "info": { "input": { "method": "GET", "pathParams": { "symbol": "BTC" }, "queryParams": { "limit": 20, "order": "strongest", "scope": "current", "side": "all", "view": "clusters" }, "type": "http" }, "output": { "example": { "clusters": { "available_buy_count": 3, "available_sell_count": 3, "buy": [ { "absolute_distance_from_reference_pct": 3.902439, "distance_from_reference_bps": -390.2439, "distance_from_reference_pct": -3.902439, "distance_from_reference_usd": -4000, "liquidation_flow": "sell", "liquidation_price": 98500, "position_count": 18, "position_side": "long", "reference_price": 102500, "reference_price_source": "hyperliquid_mark_px", "relative_to_reference": "below", "size": 120.5, "value": 12350000 }, { "absolute_distance_from_reference_pct": 5.121951, "distance_from_reference_bps": -512.1951, "distance_from_reference_pct": -5.121951, "distance_from_reference_usd": -5250, "liquidation_flow": "sell", "liquidation_price": 97250, "position_count": 14, "position_side": "long", "reference_price": 102500, "reference_price_source": "hyperliquid_mark_px", "relative_to_reference": "below", "size": 88.25, "value": 9045625 }, { "absolute_distance_from_reference_pct": 7.219512, "distance_from_reference_bps": -721.9512, "distance_from_reference_pct": -7.219512, "distance_from_reference_usd": -7400, "liquidation_flow": "sell", "liquidation_price": 95100, "position_count": 9, "position_side": "long", "reference_price": 102500, "reference_price_source": "hyperliquid_mark_px", "relative_to_reference": "below", "size": 64.75, "value": 6636875 } ], "complete": true, "order": "strongest", "published_buy_count": 3, "published_sell_count": 3, "sell": [ { "absolute_distance_from_reference_pct": 4.390244, "distance_from_reference_bps": 439.0244, "distance_from_reference_pct": 4.390244, "distance_from_reference_usd": 4500, "liquidation_flow": "buy", "liquidation_price": 107000, "position_count": 11, "position_side": "short", "reference_price": 102500, "reference_price_source": "hyperliquid_mark_px", "relative_to_reference": "above", "size": 95.25, "value": 9763125 }, { "absolute_distance_from_reference_pct": 6.829268, "distance_from_reference_bps": 682.9268, "distance_from_reference_pct": 6.829268, "distance_from_reference_usd": 7000, "liquidation_flow": "buy", "liquidation_price": 109500, "position_count": 8, "position_side": "short", "reference_price": 102500, "reference_price_source": "hyperliquid_mark_px", "relative_to_reference": "above", "size": 76.5, "value": 7841250 }, { "absolute_distance_from_reference_pct": 9.512195, "distance_from_reference_bps": 951.2195, "distance_from_reference_pct": 9.512195, "distance_from_reference_usd": 9750, "liquidation_flow": "buy", "liquidation_price": 112250, "position_count": 7, "position_side": "short", "reference_price": 102500, "reference_price_source": "hyperliquid_mark_px", "relative_to_reference": "above", "size": 58.75, "value": 6021875 } ], "side_meaning": { "buy": "legacy_key_for_long_position_liquidation_levels", "sell": "legacy_key_for_short_position_liquidation_levels" }, "side_semantics": { "buy": { "liquidation_flow": "sell", "position_side": "long" }, "sell": { "liquidation_flow": "buy", "position_side": "short" } } }, "data_as_of": 1784116800000, "freshness": { "age_seconds": 0, "data_as_of": "2026-07-15T12:00:00.000Z", "max_age_seconds": 300, "status": "fresh" }, "generated_at": "2026-07-15T12:00:00.000Z", "levels": { "available_buy_count": 3, "available_sell_count": 3, "buy": [ { "absolute_distance_from_reference_pct": 3.902439, "distance_from_reference_bps": -390.2439, "distance_from_reference_pct": -3.902439, "distance_from_reference_usd": -4000, "liquidation_flow": "sell", "liquidation_price": 98500, "position_count": 18, "position_side": "long", "reference_price": 102500, "reference_price_source": "hyperliquid_mark_px", "relative_to_reference": "below", "size": 120.5, "value": 12350000 }, { "absolute_distance_from_reference_pct": 5.121951, "distance_from_reference_bps": -512.1951, "distance_from_reference_pct": -5.121951, "distance_from_reference_usd": -5250, "liquidation_flow": "sell", "liquidation_price": 97250, "position_count": 14, "position_side": "long", "reference_price": 102500, "reference_price_source": "hyperliquid_mark_px", "relative_to_reference": "below", "size": 88.25, "value": 9045625 }, { "absolute_distance_from_reference_pct": 7.219512, "distance_from_reference_bps": -721.9512, "distance_from_reference_pct": -7.219512, "distance_from_reference_usd": -7400, "liquidation_flow": "sell", "liquidation_price": 95100, "position_count": 9, "position_side": "long", "reference_price": 102500, "reference_price_source": "hyperliquid_mark_px", "relative_to_reference": "below", "size": 64.75, "value": 6636875 } ], "complete": true, "order": "strongest", "published_buy_count": 3, "published_sell_count": 3, "sell": [ { "absolute_distance_from_reference_pct": 4.390244, "distance_from_reference_bps": 439.0244, "distance_from_reference_pct": 4.390244, "distance_from_reference_usd": 4500, "liquidation_flow": "buy", "liquidation_price": 107000, "position_count": 11, "position_side": "short", "reference_price": 102500, "reference_price_source": "hyperliquid_mark_px", "relative_to_reference": "above", "size": 95.25, "value": 9763125 }, { "absolute_distance_from_reference_pct": 6.829268, "distance_from_reference_bps": 682.9268, "distance_from_reference_pct": 6.829268, "distance_from_reference_usd": 7000, "liquidation_flow": "buy", "liquidation_price": 109500, "position_count": 8, "position_side": "short", "reference_price": 102500, "reference_price_source": "hyperliquid_mark_px", "relative_to_reference": "above", "size": 76.5, "value": 7841250 }, { "absolute_distance_from_reference_pct": 9.512195, "distance_from_reference_bps": 951.2195, "distance_from_reference_pct": 9.512195, "distance_from_reference_usd": 9750, "liquidation_flow": "buy", "liquidation_price": 112250, "position_count": 7, "position_side": "short", "reference_price": 102500, "reference_price_source": "hyperliquid_mark_px", "relative_to_reference": "above", "size": 58.75, "value": 6021875 } ], "side_meaning": { "buy": "legacy_key_for_long_position_liquidation_levels", "sell": "legacy_key_for_short_position_liquidation_levels" }, "side_semantics": { "buy": { "liquidation_flow": "sell", "position_side": "long" }, "sell": { "liquidation_flow": "buy", "position_side": "short" } } }, "margin_stress": { "interpretation": "Public market liquidation exposure estimate; not an account margin requirement or liquidation guarantee.", "method": "liquidation_buckets_crossed_from_reference_price", "reference_price": 102500, "reference_price_source": "hyperliquid_mark_px", "scenarios": [ { "crossed_bucket_count": 18, "estimated_liquidation_notional_usd": 21395625, "estimated_liquidation_size": 208.75, "estimated_position_count": 32, "liquidated_side": "long", "move_pct": -5, "target_price": 97375 }, { "crossed_bucket_count": 9, "estimated_liquidation_notional_usd": 9763125, "estimated_liquidation_size": 95.25, "estimated_position_count": 11, "liquidated_side": "short", "move_pct": 5, "target_price": 107625 } ], "trigger_basis": "hyperliquid_mark_price" }, "market_reference": { "mark": 102500, "midpoint": 102510, "oracle": 102480, "price": 102500, "source": "hyperliquid_mark_px", "trigger_basis": "hyperliquid_mark_price" }, "product_version": "v1", "schema": "hyperliquid_liquidation_map.v1", "scope": "current", "service": "omni.hyperliquid_liquidation_map", "summary": { "buy_lvwap_by_value": 86100, "legacy_liquidation_distribution_mid_proxy": 101250, "positions_with_liquidation_price": 24410, "reference_price": 102500, "reference_price_source": "hyperliquid_mark_px", "sell_lvwap_by_value": 119400, "total_positions": 27875, "total_size": 15240.25, "total_value": 1562125625 }, "symbol": "BTC", "usage": { "item_limit": 20, "published_level_count": 6, "published_levels_complete": true }, "view": "clusters" }, "type": "json" } }, "routeTemplate": "/api/x402/v1/liquidations/:symbol", "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "properties": { "input": { "additionalProperties": false, "properties": { "method": { "enum": [ "GET" ], "type": "string" }, "pathParams": { "properties": { "symbol": { "description": "Allowlisted market symbol, for example BTC", "type": "string" } }, "required": [ "symbol" ], "type": "object" }, "queryParams": { "properties": { "around_price": { "description": "Optional reference price used by nearest ordering.", "exclusiveMinimum": 0, "type": "number" }, "limit": { "default": 20, "maximum": 50, "minimum": 1, "type": "integer" }, "order": { "default": "strongest", "enum": [ "strongest", "nearest", "price" ], "type": "string" }, "scope": { "default": "current", "enum": [ "current", "aggregate" ], "type": "string" }, "side": { "default": "all", "enum": [ "all", "long", "short" ], "type": "string" }, "view": { "default": "summary", "enum": [ "summary", "buckets", "clusters", "flow" ], "type": "string" } }, "type": "object" }, "type": { "const": "http", "type": "string" } }, "required": [ "type", "method" ], "type": "object" }, "output": { "properties": { "example": { "type": "object" }, "type": { "type": "string" } }, "required": [ "type" ], "type": "object" } }, "required": [ "input" ], "type": "object" } }, "builder-code": { "info": { "a": "bc_wttcxbb6" }, "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "a": { "description": "App builder code", "pattern": "^[a-z0-9_]{1,32}$", "type": "string" }, "s": { "description": "Service builder codes", "items": { "pattern": "^[a-z0-9_]{1,32}$", "type": "string" }, "type": "array" }, "w": { "description": "Wallet builder code", "pattern": "^[a-z0-9_]{1,32}$", "type": "string" } }, "type": "object" } } }, "tags": [ "bazaar", "builder-code" ], "sourceHost": "omniterminal.app", "lastUpdated": "2026-09-05T09:40:44.766Z", "quality": { "calls30d": 15, "uniquePayers30d": 3, "lastCalledAt": "2026-09-05T09:40:44.299Z" }, "liveness": {}, "verified": false, "featured": false, "provider": { "host": "omniterminal.app", "manifest_name": "omniterminal.app", "source": "cdp-mirror", "source_manifest_url": "https://api.cdp.coinbase.com/platform/v2/x402/discovery/resources", "submitted_at": "2026-09-18T22:00:31.484Z" } }