{
  "id": "surf.market.listing",
  "object": "tool",
  "name": "Exchange Listing Events",
  "summary": "Returns historical exchange listing and delisting events.",
  "description": "Returns historical exchange listing and delisting events. Filters: date range, exchange, token symbol, product type, event type.\n\nRaw surf#market/listing endpoint: input is { body, queryParams, pathParams } as the provider documents them (https://docs.asksurf.ai/data-api/market/listing).",
  "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_listing",
  "input_schema": {
    "type": "object",
    "properties": {
      "queryParams": {
        "type": "object",
        "properties": {
          "from": {
            "type": "string",
            "minLength": 1,
            "description": "Start date (YYYY-MM-DD or ISO 8601). Example: 2024-01-01."
          },
          "to": {
            "type": "string",
            "minLength": 1,
            "description": "End date (defaults to now). Example: 2024-03-01."
          },
          "symbol": {
            "type": "string",
            "minLength": 1,
            "description": "Filter by token symbol. Example: BTC."
          },
          "exchange": {
            "type": "string",
            "minLength": 1,
            "description": "Filter by exchange name. Example: binance."
          },
          "product": {
            "default": "all",
            "type": "string",
            "enum": [
              "spot",
              "margin",
              "perp",
              "pre_market_perp",
              "all"
            ],
            "description": "Filter by product type. Defaults to \"all\"."
          },
          "type": {
            "default": "listing",
            "type": "string",
            "enum": [
              "listing",
              "delisting",
              "cancelled",
              "advanced",
              "postponed"
            ],
            "description": "Event type filter. Defaults to \"listing\"."
          },
          "limit": {
            "default": 20,
            "type": "integer",
            "minimum": 1,
            "maximum": 100,
            "description": "Results per page. Defaults to 20."
          },
          "offset": {
            "default": 0,
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991,
            "description": "Pagination offset. Defaults to 0."
          }
        },
        "required": [
          "from"
        ],
        "additionalProperties": false
      }
    },
    "required": [
      "queryParams"
    ],
    "additionalProperties": false
  },
  "kind": "endpoint"
}