{
  "id": "surf.market.liquidation.chart",
  "object": "tool",
  "name": "Liquidation Chart",
  "summary": "Returns OHLC-style aggregated liquidation data for a token on a specific exchange.",
  "description": "Returns OHLC-style aggregated liquidation data for a token on a specific exchange. Filters: symbol, exchange, interval. Useful for charting liquidation volume over time.\n\nRaw surf#market/liquidation/chart endpoint: input is { body, queryParams, pathParams } as the provider documents them (https://docs.asksurf.ai/data-api/market/liquidation-chart).",
  "category": "lookup",
  "hosted_by": "Surf",
  "runtime": "partner",
  "side_effects": false,
  "status": "live",
  "credits": 0,
  "price": null,
  "providers": [
    {
      "id": "surf",
      "name": "Surf",
      "price": null,
      "own_key_only": true
    }
  ],
  "mcp_name": "surf_market_liquidation_chart",
  "input_schema": {
    "type": "object",
    "properties": {
      "queryParams": {
        "type": "object",
        "properties": {
          "symbol": {
            "type": "string",
            "minLength": 1,
            "description": "Token ticker symbol like BTC or ETH. Example: BTC."
          },
          "interval": {
            "default": "1h",
            "type": "string",
            "enum": [
              "1m",
              "3m",
              "5m",
              "15m",
              "30m",
              "1h",
              "4h",
              "6h",
              "8h",
              "12h",
              "1d",
              "1w"
            ],
            "description": "Candlestick interval — bucket size for each point in the liquidation chart series: 1m, 3m, 5m, 15m, 30m, 1h, 4h, 6h, 8h, 12h, 1d, or 1w. This endpoint uses interval only; it does NOT accept time_range. Use from/to to bound the series. Example: 1h. Defaults to \"1h\"."
          },
          "exchange": {
            "default": "Binance",
            "type": "string",
            "enum": [
              "Binance",
              "OKX",
              "Bybit",
              "Bitget",
              "Hyperliquid",
              "Gate",
              "HTX",
              "Bitmex",
              "Bitfinex",
              "CoinEx",
              "Aster",
              "Lighter"
            ],
            "description": "Exchange name. Can be Binance, OKX, Bybit, Bitget, Hyperliquid, Gate, HTX, Bitmex, Bitfinex, CoinEx, Aster, or Lighter. Example: Binance. Defaults to \"Binance\"."
          },
          "limit": {
            "default": 500,
            "type": "integer",
            "minimum": 1,
            "maximum": 4500,
            "description": "Results per page. Example: 500. Defaults to 500."
          },
          "from": {
            "type": "string",
            "minLength": 1,
            "description": "Start of time range. Accepts Unix seconds (1704067200) or date string (2024-01-01). Example: 2024-01-01."
          },
          "to": {
            "type": "string",
            "minLength": 1,
            "description": "End of time range. Accepts Unix seconds (1706745600) or date string (2024-02-01). Example: 2024-02-01."
          }
        },
        "required": [
          "symbol"
        ],
        "additionalProperties": false
      }
    },
    "required": [
      "queryParams"
    ],
    "additionalProperties": false
  },
  "kind": "endpoint"
}