{
  "id": "surf.market.liquidation.exchange-list",
  "object": "tool",
  "name": "Liquidation by Exchange",
  "summary": "Returns liquidation breakdown by exchange in a single ranked snapshot.",
  "description": "Returns liquidation breakdown by exchange in a single ranked snapshot. Included fields: total, long, and short volumes in USD. Filters: symbol and time_range (1h, 4h, 12h, 24h). No pagination and no interval — this endpoint does NOT accept limit, offset, or interval. Returns the full exchange list in one response.\n\nRaw surf#market/liquidation/exchange-list endpoint: input is { body, queryParams, pathParams } as the provider documents them (https://docs.asksurf.ai/data-api/market/liquidation-exchange-list).",
  "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_exchange-list",
  "input_schema": {
    "type": "object",
    "properties": {
      "queryParams": {
        "type": "object",
        "properties": {
          "symbol": {
            "default": "BTC",
            "type": "string",
            "minLength": 1,
            "description": "Token ticker symbol like BTC or ETH. Example: BTC. Defaults to \"BTC\"."
          },
          "time_range": {
            "default": "24h",
            "type": "string",
            "enum": [
              "1h",
              "4h",
              "12h",
              "24h"
            ],
            "description": "Window to aggregate over for the snapshot: 1h, 4h, 12h, or 24h. Returns a single snapshot (not a time-series). This endpoint uses time_range only — it does NOT accept interval. Example: 24h. Defaults to \"24h\"."
          },
          "sort_by": {
            "default": "liquidation_usd",
            "type": "string",
            "enum": [
              "liquidation_usd",
              "long_liquidation_usd",
              "short_liquidation_usd"
            ],
            "description": "Field to sort results by. Example: liquidation_usd. Defaults to \"liquidation_usd\"."
          },
          "order": {
            "default": "desc",
            "type": "string",
            "enum": [
              "asc",
              "desc"
            ],
            "description": "Sort order. Example: desc. Defaults to \"desc\"."
          }
        },
        "additionalProperties": false
      }
    },
    "required": [],
    "additionalProperties": false
  },
  "kind": "endpoint"
}