ASasksurf
Exchange

Exchange OHLCV Candlesticks

Returns OHLCV candlestick data with period summary stats (high, low, total volume).

Intervals: 15 options from 1m to 1M.

Pagination: use from to set the start time and limit to control candle count. For longer ranges, pass the last returned candle's timestamp as the next from value. Exchange-side limits vary (200–1000 per request).

Set type=swap to query perpetual contract candles instead of spot.

get/gateway/v1/exchange/klines

Request

  • Base URL
    https://api.asksurf.ai
  • Auth
    HTTP bearer

Query parameters

pairstring required

Trading pair (e.g. BTC/USDT)

Example:BTC/USDT
type'spot' | 'swap' | 'perpetual' | 'perp'

Market type: spot for spot trading, swap/perpetual/perp for perpetual contracts

Example:spot
interval'1m' | '3m' | '5m' | '15m' | '30m' | '1h' | '2h' | '4h' | '6h' | '8h' | '12h' | '1d' | '3d' | '1w' | '1M'

Candle size — bucket duration for each returned OHLCV row. This endpoint uses interval only; it does NOT accept time_range. Use from + limit to control the window.

Example:1h
fromstring

Start of time range. Accepts Unix seconds or date string (YYYY-MM-DD, ISO8601)

Example:2026-03-01
limitinteger

Max number of candles to return. Exchange may cap lower (e.g. 200-1000). For longer ranges, paginate using the last returned timestamp as the next from value.

Example:100
exchange'binance' | 'okx' | 'bybit' | 'bitget' | 'coinbase' | 'kraken' | 'gate' | 'htx' | 'kucoin' | 'mexc' | 'upbit' | 'bitfinex' | 'bitstamp' | 'deribit' | 'bitmex' | 'bithumb' | 'hyperliquid'

Exchange identifier. Note: hyperliquid uses USDC-settled perps (e.g. BTC/USDC:USDC); pass USDC-quoted pairs when querying hyperliquid.

Example:binance

Response

OK

$schemastring uri

A URL to the JSON Schema for this object.

Example response

{
  "$schema": "https://example.com/schemas/SimpleListResponseExchangeKlineResponse.json"
}

Changes

No recorded changes to this operation across all 12 revisions of this API.