Omni Terminal

Omni Terminal provides Hyperliquid price structure with bounded OHLCV candles, current funding/carry, and an optional mark-anchored all-level liquidation and margin-stress overlay.

Resource: omniterminal.app/api/x402/v1/market-snapshot/:symbol

Network: eip155:84532, eip155:8453 · Asset: 0x036CbD53842c5426634e7929541eC2318f3dCF7e · Pay to: 0x733f40A4FA0cd13d59aBADE04b9eD2e9acAc6457

Payment methods: — · Last validation: 2026-09-14 11:22:36.449+00

{
  "input": {
    "type": "http",
    "method": "GET",
    "pathParams": {
      "symbol": "BTC"
    },
    "queryParams": {
      "limit": 120,
      "scope": "aggregate",
      "interval": "1h",
      "include_liquidations": true
    }
  },
  "output": {
    "type": "json",
    "example": {
      "scope": "aggregate",
      "usage": {
        "candle_count": 1,
        "candle_limit": 120,
        "funding_included": true,
        "liquidation_overlay_included": true
      },
      "schema": "hyperliquid_market_snapshot.v1",
      "symbol": "BTC",
      "candles": [
        {
          "low": 116850,
          "high": 117900,
          "open": 117200,
          "close": 117640,
          "trades": 4210,
          "volume": 1824.5,
          "open_time": 1784627200000,
          "close_time": 1784630799999
        }
      ],
      "funding": {
        "dex": "main",
        "carry": {
          "premium": -0.0002979165,
          "funding_apr_pct": 10.95,
          "funding_rate_1d": 0.0003,
          "funding_rate_8h": 0.0001,
          "projection_basis": "current_hourly_rate_mechanical_projection",
          "funding_direction": "longs_pay_shorts",
          "settlement_interval": "1h",
          "annualization_method": "simple_current_hourly_rate_x_8760",
          "funding_rate_per_hour": 0.0000125,
          "funding_annualized_pct": 10.95
        },
        "quote": "USDC",
        "usage": {
          "current_snapshot_only": true,
          "historical_series_included": false
        },
        "venue": "hyperliquid",
        "prices": {
          "mark": 63440.5,
          "oracle": 63440.5,
          "midpoint": 63440.5,
          "previous_day": 65087,
          "price_change_24h_pct": -2.5297,
          "mark_oracle_basis_bps": 0
        },
        "schema": "hyperliquid_market_carry.v1",
        "symbol": "BTC",
        "service": "omni.hyperliquid_market_carry",
        "freshness": {
          "status": "fresh",
          "data_as_of": "2026-07-28T11:59:55.000Z",
          "age_seconds": 5,
          "max_age_seconds": 120
        },
        "data_as_of": "2026-07-28T11:59:55.000Z",
        "market_type": "perp",
        "positioning": {
          "day_base_volume": 35060.91552,
          "open_interest_usd": 2324264117.62,
          "open_interest_base": 36639.5983,
          "day_notional_volume_usd": 2255876954.93
        },
        "generated_at": "2026-07-28T12:00:00.000Z",
        "product_version": "v1",
        "canonical_symbol": "hyperliquid:BTC:USDC:perp"
      },
      "service": "omni.hyperliquid_market_snapshot",
      "interval": "1h",
      "freshness": {
        "status": "fresh",
        "data_as_of": "2026-07-21T12:00:00.000Z",
        "age_seconds": 0,
        "max_age_seconds": 7200
      },
      "data_as_of": "2026-07-21T12:00:00.000Z",
      "generated_at": "2026-07-21T12:00:00.000Z",
      "product_version": "v1",
      "liquidation_overlay": {
        "view": "clusters",
        "scope": "current",
        "usage": {
          "item_limit": 20,
          "published_level_count": 4,
          "published_levels_complete": true
        },
        "levels": {
          "buy": [
            {
              "size": 120.5,
              "value": 12350000,
              "position_side": "long",
              "position_count": 18,
              "reference_price": 102500,
              "liquidation_flow": "sell",
              "liquidation_price": 98500,
              "relative_to_reference": "below",
              "reference_price_source": "hyperliquid_mark_px",
              "distance_from_reference_bps": -390.2439,
              "distance_from_reference_pct": -3.902439,
              "distance_from_reference_usd": -4000,
              "absolute_distance_from_reference_pct": 3.902439
            },
            {
              "size": 88.25,
              "value": 9045625,
              "position_side": "long",
              "position_count": 14,
              "reference_price": 102500,
              "liquidation_flow": "sell",
              "liquidation_price": 97250,
              "relative_to_reference": "below",
              "reference_price_source": "hyperliquid_mark_px",
              "distance_from_reference_bps": -512.1951,
              "distance_from_reference_pct": -5.121951,
              "distance_from_reference_usd": -5250,
              "absolute_distance_from_reference_pct": 5.121951
            }
          ],
          "sell": [
            {
              "size": 95.25,
              "value": 9763125,
              "position_side": "short",
              "position_count": 11,
              "reference_price": 102500,
              "liquidation_flow": "buy",
              "liquidation_price": 107000,
              "relative_to_reference": "above",
              "reference_price_source": "hyperliquid_mark_px",
              "distance_from_reference_bps": 439.0244,
              "distance_from_reference_pct": 4.390244,
              "distance_from_reference_usd": 4500,
              "absolute_distance_from_reference_pct": 4.390244
            },
            {
              "size": 76.5,
              "value": 7841250,
              "position_side": "short",
              "position_count": 8,
              "reference_price": 102500,
              "liquidation_flow": "buy",
              "liquidation_price": 109500,
              "relative_to_reference": "above",
              "reference_price_source": "hyperliquid_mark_px",
              "distance_from_reference_bps": 682.9268,
              "distance_from_reference_pct": 6.829268,
              "distance_from_reference_usd": 7000,
              "absolute_distance_from_reference_pct": 6.829268
            }
          ],
          "order": "strongest",
          "complete": true,
          "side_meaning": {
            "buy": "legacy_key_for_long_position_liquidation_levels",
            "sell": "legacy_key_for_short_position_liquidation_levels"
          },
          "side_semantics": {
            "buy": {
              "position_side": "long",
              "liquidation_flow": "sell"
            },
            "sell": {
              "position_side": "short",
              "liquidation_flow": "buy"
            }
          },
          "available_buy_count": 2,
          "published_buy_count": 2,
          "available_sell_count": 2,
          "published_sell_count": 2
        },
        "schema": "hyperliquid_liquidation_map.v1",
        "symbol": "BTC",
        "service": "omni.hyperliquid_liquidation_map",
        "summary": {
          "total_size": 15240.25,
          "total_value": 1562125625,
          "reference_price": 102500,
          "total_positions": 27875,
          "buy_lvwap_by_value": 86100,
          "sell_lvwap_by_value": 119400,
          "reference_price_source": "hyperliquid_mark_px",
          "positions_with_liquidation_price": 24410,
          "legacy_liquidation_distribution_mid_proxy": 101250
        },
        "freshness": {
          "status": "fresh",
          "data_as_of": "2026-07-15T12:00:00.000Z",
          "age_seconds": 0,
          "max_age_seconds": 300
        },
        "data_as_of": 1784116800000,
        "generated_at": "2026-07-15T12:00:00.000Z",
        "margin_stress": {
          "method": "liquidation_buckets_crossed_from_reference_price",
          "scenarios": [
            {
              "move_pct": -5,
              "target_price": 97375,
              "liquidated_side": "long",
              "crossed_bucket_count": 18,
              "estimated_position_count": 32,
              "estimated_liquidation_size": 208.75,
              "estimated_liquidation_notional_usd": 21395625
            },
            {
              "move_pct": 5,
              "target_price": 107625,
              "liquidated_side": "short",
              "crossed_bucket_count": 9,
              "estimated_position_count": 11,
              "estimated_liquidation_size": 95.25,
              "estimated_liquidation_notional_usd": 9763125
            }
          ],
          "trigger_basis": "hyperliquid_mark_price",
          "interpretation": "Public market liquidation exposure estimate; not an account margin requirement or liquidation guarantee.",
          "reference_price": 102500,
          "reference_price_source": "hyperliquid_mark_px"
        },
        "product_version": "v1",
        "market_reference": {
          "mark": 102500,
          "price": 102500,
          "oracle": 102480,
          "source": "hyperliquid_mark_px",
          "midpoint": 102510,
          "trigger_basis": "hyperliquid_mark_price"
        }
      }
    }
  },
  "paymentRequirements": [
    {
      "raw": {
        "asset": "0x036CbD53842c5426634e7929541eC2318f3dCF7e",
        "extra": {
          "name": "USDC",
          "version": "2"
        },
        "payTo": "0x733f40A4FA0cd13d59aBADE04b9eD2e9acAc6457",
        "amount": "5000",
        "scheme": "exact",
        "network": "eip155:84532",
        "maxTimeoutSeconds": 300
      },
      "asset": "0x036CbD53842c5426634e7929541eC2318f3dCF7e",
      "payTo": "0x733f40A4FA0cd13d59aBADE04b9eD2e9acAc6457",
      "scheme": "exact",
      "network": "eip155:84532",
      "amountAtomic": "5000"
    },
    {
      "raw": {
        "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
        "extra": {
          "name": "USD Coin",
          "version": "2"
        },
        "payTo": "0x733f40A4FA0cd13d59aBADE04b9eD2e9acAc6457",
        "amount": "5000",
        "scheme": "exact",
        "network": "eip155:8453",
        "maxTimeoutSeconds": 300
      },
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "payTo": "0x733f40A4FA0cd13d59aBADE04b9eD2e9acAc6457",
      "scheme": "exact",
      "network": "eip155:8453",
      "amountAtomic": "5000"
    }
  ]
}

Source catalog records are retained separately from live endpoint observations. Sonar score, uptime, and latency are advisory metrics. CDP indexing is not inferred from validation.