Token Listing & Delisting

GET/gateway/v1/market/listing

Returns historical exchange listing and delisting events.

Filters: date range, exchange, token symbol, product type, event type.

Query Parameters

fromstringrequired

Start date (YYYY-MM-DD or ISO 8601)

Example: 2024-01-01

tostring

End date (defaults to now)

Example: 2024-03-01

symbolstring

Filter by token symbol

Example: BTC

exchangestring

Filter by exchange name

Example: binance

productenum<string>

Filter by product type

Available options:spotmarginperppre_market_perpall

typeenum<string>

Event type filter

Available options:listingdelistingcancelledadvancedpostponed

limitinteger

Results per page

offsetinteger

Pagination offset

Token Listing & Delisting

const options = {method: 'GET'};

fetch('https://api.asksurf.ai/gateway/v1/market/listing?from=2024-01-01&to=2024-03-01&symbol=BTC&exchange=binance', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "$schema": "https://example.com/schemas/DataResponseListingEventItem.json",
  "data": [
    {
      "base_symbol": "<string>",
      "effective_at": 123,
      "event_type": "<string>",
      "exchange_name": "<string>",
      "product": "<string>",
      "published_at": 123,
      "quote_symbol": "<string>",
      "trading_pair": "<string>"
    }
  ],
  "meta": {
    "cached": true,
    "credits_used": 123,
    "empty_reason": "<string>",
    "has_more": true,
    "limit": 123,
    "offset": 123,
    "total": 123,
    "watermark": 123
  }
}