{
  "x402Version": 2,
  "id": 26337,
  "slug": "26337",
  "resource": "https://omniterminal.app/api/x402/v1/market-snapshot/:symbol",
  "description": "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.",
  "type": "http",
  "serviceName": "Omni Terminal",
  "iconUrl": "https://res.cloudinary.com/bdb-prod/image/upload/c_fill,ar_1:1,w_256,h_256,f_auto,q_auto/v1786439307/bazaar-icons/74fa8868286482a1.png",
  "resourceType": "Payments",
  "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",
      "amountUsd": 0.005,
      "maxTimeoutSeconds": 300
    }
  ],
  "outputSchema": {
    "properties": {
      "example": {
        "type": "object"
      },
      "type": {
        "type": "string"
      }
    },
    "required": [
      "type"
    ],
    "type": "object"
  },
  "extensions": {
    "bazaar": {
      "info": {
        "input": {
          "method": "GET",
          "pathParams": {
            "symbol": "BTC"
          },
          "queryParams": {
            "include_liquidations": true,
            "interval": "1h",
            "limit": 120,
            "scope": "aggregate"
          },
          "type": "http"
        },
        "output": {
          "example": {
            "candles": [
              {
                "close": 117640,
                "close_time": 1784630799999,
                "high": 117900,
                "low": 116850,
                "open": 117200,
                "open_time": 1784627200000,
                "trades": 4210,
                "volume": 1824.5
              }
            ],
            "data_as_of": "2026-07-21T12:00:00.000Z",
            "freshness": {
              "age_seconds": 0,
              "data_as_of": "2026-07-21T12:00:00.000Z",
              "max_age_seconds": 7200,
              "status": "fresh"
            },
            "funding": {
              "canonical_symbol": "hyperliquid:BTC:USDC:perp",
              "carry": {
                "annualization_method": "simple_current_hourly_rate_x_8760",
                "funding_annualized_pct": 10.95,
                "funding_apr_pct": 10.95,
                "funding_direction": "longs_pay_shorts",
                "funding_rate_1d": 0.0003,
                "funding_rate_8h": 0.0001,
                "funding_rate_per_hour": 0.0000125,
                "premium": -0.0002979165,
                "projection_basis": "current_hourly_rate_mechanical_projection",
                "settlement_interval": "1h"
              },
              "data_as_of": "2026-07-28T11:59:55.000Z",
              "dex": "main",
              "freshness": {
                "age_seconds": 5,
                "data_as_of": "2026-07-28T11:59:55.000Z",
                "max_age_seconds": 120,
                "status": "fresh"
              },
              "generated_at": "2026-07-28T12:00:00.000Z",
              "market_type": "perp",
              "positioning": {
                "day_base_volume": 35060.91552,
                "day_notional_volume_usd": 2255876954.93,
                "open_interest_base": 36639.5983,
                "open_interest_usd": 2324264117.62
              },
              "prices": {
                "mark": 63440.5,
                "mark_oracle_basis_bps": 0,
                "midpoint": 63440.5,
                "oracle": 63440.5,
                "previous_day": 65087,
                "price_change_24h_pct": -2.5297
              },
              "product_version": "v1",
              "quote": "USDC",
              "schema": "hyperliquid_market_carry.v1",
              "service": "omni.hyperliquid_market_carry",
              "symbol": "BTC",
              "usage": {
                "current_snapshot_only": true,
                "historical_series_included": false
              },
              "venue": "hyperliquid"
            },
            "generated_at": "2026-07-21T12:00:00.000Z",
            "interval": "1h",
            "liquidation_overlay": {
              "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": 2,
                "available_sell_count": 2,
                "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
                  }
                ],
                "complete": true,
                "order": "strongest",
                "published_buy_count": 2,
                "published_sell_count": 2,
                "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
                  }
                ],
                "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": 4,
                "published_levels_complete": true
              },
              "view": "clusters"
            },
            "product_version": "v1",
            "schema": "hyperliquid_market_snapshot.v1",
            "scope": "aggregate",
            "service": "omni.hyperliquid_market_snapshot",
            "symbol": "BTC",
            "usage": {
              "candle_count": 1,
              "candle_limit": 120,
              "funding_included": true,
              "liquidation_overlay_included": true
            }
          },
          "type": "json"
        }
      },
      "routeTemplate": "/api/x402/v1/market-snapshot/: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": {
                  "include_liquidations": {
                    "default": true,
                    "type": "boolean"
                  },
                  "interval": {
                    "default": "1h",
                    "enum": [
                      "1m",
                      "5m",
                      "15m",
                      "1h",
                      "2h",
                      "4h",
                      "8h",
                      "1d",
                      "3d",
                      "1w",
                      "1M"
                    ],
                    "type": "string"
                  },
                  "limit": {
                    "default": 120,
                    "maximum": 200,
                    "minimum": 20,
                    "type": "integer"
                  },
                  "scope": {
                    "default": "aggregate",
                    "enum": [
                      "current",
                      "aggregate"
                    ],
                    "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": [
    "omni-terminal",
    "trading",
    "market-data",
    "hyperliquid",
    "market-snapshot",
    "bazaar",
    "builder-code"
  ],
  "sourceHost": "omniterminal.app",
  "lastUpdated": "2026-10-07T09:57:32.546Z",
  "quality": {
    "calls30d": 2,
    "uniquePayers30d": 2,
    "lastCalledAt": "2026-10-07T09:57:32.286Z"
  },
  "metadata": {
    "serviceName": "Omni Terminal",
    "iconUrl": "https://res.cloudinary.com/bdb-prod/image/upload/c_fill,ar_1:1,w_256,h_256,f_auto,q_auto/v1786439307/bazaar-icons/74fa8868286482a1.png",
    "extensions": {
      "bazaar": {
        "info": {
          "input": {
            "method": "GET",
            "pathParams": {
              "symbol": "BTC"
            },
            "queryParams": {
              "include_liquidations": true,
              "interval": "1h",
              "limit": 120,
              "scope": "aggregate"
            },
            "type": "http"
          },
          "output": {
            "example": {
              "candles": [
                {
                  "close": 117640,
                  "close_time": 1784630799999,
                  "high": 117900,
                  "low": 116850,
                  "open": 117200,
                  "open_time": 1784627200000,
                  "trades": 4210,
                  "volume": 1824.5
                }
              ],
              "data_as_of": "2026-07-21T12:00:00.000Z",
              "freshness": {
                "age_seconds": 0,
                "data_as_of": "2026-07-21T12:00:00.000Z",
                "max_age_seconds": 7200,
                "status": "fresh"
              },
              "funding": {
                "canonical_symbol": "hyperliquid:BTC:USDC:perp",
                "carry": {
                  "annualization_method": "simple_current_hourly_rate_x_8760",
                  "funding_annualized_pct": 10.95,
                  "funding_apr_pct": 10.95,
                  "funding_direction": "longs_pay_shorts",
                  "funding_rate_1d": 0.0003,
                  "funding_rate_8h": 0.0001,
                  "funding_rate_per_hour": 0.0000125,
                  "premium": -0.0002979165,
                  "projection_basis": "current_hourly_rate_mechanical_projection",
                  "settlement_interval": "1h"
                },
                "data_as_of": "2026-07-28T11:59:55.000Z",
                "dex": "main",
                "freshness": {
                  "age_seconds": 5,
                  "data_as_of": "2026-07-28T11:59:55.000Z",
                  "max_age_seconds": 120,
                  "status": "fresh"
                },
                "generated_at": "2026-07-28T12:00:00.000Z",
                "market_type": "perp",
                "positioning": {
                  "day_base_volume": 35060.91552,
                  "day_notional_volume_usd": 2255876954.93,
                  "open_interest_base": 36639.5983,
                  "open_interest_usd": 2324264117.62
                },
                "prices": {
                  "mark": 63440.5,
                  "mark_oracle_basis_bps": 0,
                  "midpoint": 63440.5,
                  "oracle": 63440.5,
                  "previous_day": 65087,
                  "price_change_24h_pct": -2.5297
                },
                "product_version": "v1",
                "quote": "USDC",
                "schema": "hyperliquid_market_carry.v1",
                "service": "omni.hyperliquid_market_carry",
                "symbol": "BTC",
                "usage": {
                  "current_snapshot_only": true,
                  "historical_series_included": false
                },
                "venue": "hyperliquid"
              },
              "generated_at": "2026-07-21T12:00:00.000Z",
              "interval": "1h",
              "liquidation_overlay": {
                "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": 2,
                  "available_sell_count": 2,
                  "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
                    }
                  ],
                  "complete": true,
                  "order": "strongest",
                  "published_buy_count": 2,
                  "published_sell_count": 2,
                  "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
                    }
                  ],
                  "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": 4,
                  "published_levels_complete": true
                },
                "view": "clusters"
              },
              "product_version": "v1",
              "schema": "hyperliquid_market_snapshot.v1",
              "scope": "aggregate",
              "service": "omni.hyperliquid_market_snapshot",
              "symbol": "BTC",
              "usage": {
                "candle_count": 1,
                "candle_limit": 120,
                "funding_included": true,
                "liquidation_overlay_included": true
              }
            },
            "type": "json"
          }
        },
        "routeTemplate": "/api/x402/v1/market-snapshot/: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": {
                    "include_liquidations": {
                      "default": true,
                      "type": "boolean"
                    },
                    "interval": {
                      "default": "1h",
                      "enum": [
                        "1m",
                        "5m",
                        "15m",
                        "1h",
                        "2h",
                        "4h",
                        "8h",
                        "1d",
                        "3d",
                        "1w",
                        "1M"
                      ],
                      "type": "string"
                    },
                    "limit": {
                      "default": 120,
                      "maximum": 200,
                      "minimum": 20,
                      "type": "integer"
                    },
                    "scope": {
                      "default": "aggregate",
                      "enum": [
                        "current",
                        "aggregate"
                      ],
                      "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"
        }
      }
    }
  },
  "liveness": {
    "reliability": null
  },
  "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-10-14T01:15:01.050Z"
  },
  "exampleResponse": {
    "example": {},
    "type": "string"
  }
}