Market Coverage

GET/gateway/v1/exchange/coverage

Returns covered spot markets with latest ticker metrics, candle availability, technical score, and data status.

Ticker fields: latest price, 24h open/high/low, previous close, signed 24h price and percent change, and 24h base/quote volume when the exchange provides them.

Use this endpoint to discover which Asian exchange markets have persisted market data. Use the returned `pair` values with `/exchange/candles` for historical OHLCV.

bitFlyer note: bitFlyer coverage is currently strongest for weekly (`1w`) OHLCV; latest ticker and shorter candle intervals may be unavailable.

Query Parameters

exchangeenum<string>

Exchange identifier. When omitted, returns all supported exchanges.

Available options:bithumbupbithashkeybitflyer

Example: bithumb

qstring

Free-text search over pair, base currency, or quote currency

Example: BTC

quotestring

Quote currency filter

Example: KRW

typeenum<string>

Market type

Available options:spot

Example: spot

statusenum<string>

Market status filter

Available options:activeinactive

Example: active

data_statusenum<string>

Market data coverage status filter

Available options:coveredofficial_empty_allofficial_empty_tickerofficial_empty_5mofficial_empty_weeklystale_gt_7dstale_30m_to_7drecent_but_lt_min_ta_candlesmissing_4hmissing_latest_ta

Example: covered

sort_byenum<string>

Sort field

Available options:pairpricechange_24hvolume_24htechnical_scorelatest_candle_atstatus

Example: pair

orderenum<string>

Sort order

Available options:ascdesc

Example: asc

limitinteger

Results per page

Example: 20

offsetinteger

Pagination offset

Example: 0

Market Coverage

const options = {method: 'GET'};

fetch('https://api.asksurf.ai/gateway/v1/exchange/coverage?exchange=bithumb&q=BTC&quote=KRW&type=spot&status=active&data_status=covered&sort_by=pair&order=asc&limit=20&offset=0', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "$schema": "https://example.com/schemas/DataResponseExchangeCoverageItem.json",
  "data": [
    {
      "active": true,
      "base": "<string>",
      "change_24h_abs": 123,
      "change_24h_pct": 123,
      "data_actionability": "<string>",
      "data_status": "<string>",
      "exchange": "<string>",
      "high_24h": 123,
      "latest_4h_candle_at": 123,
      "latest_5m_candle_at": 123,
      "latest_candle_at": 123,
      "latest_price": 123,
      "latest_ticker_at": 123,
      "latest_weekly_candle_at": 123,
      "listing_date": 123,
      "low_24h": 123,
      "open_24h": 123,
      "pair": "<string>",
      "prev_close": 123,
      "quote": "<string>",
      "region": "<string>",
      "status": "<string>",
      "technical_score": 123,
      "technical_score_at": 123,
      "technical_score_label": "<string>",
      "type": "<string>",
      "volume_24h_base": 123,
      "volume_24h_quote": 123
    }
  ],
  "meta": {
    "cached": true,
    "credits_used": 123,
    "empty_reason": "<string>",
    "has_more": true,
    "limit": 123,
    "offset": 123,
    "total": 123,
    "watermark": 123
  }
}