v1

latestOpenAPI 3.1.02026-07-243035381.4 MB

Exchange rate

Get OHLCV by Symbol - Batch

/v4/data/rate/symbol/OHLCV/batch

500 credits per API call

Get multiple historical OHLCV (Open, High, Low, Close, Volume) candles for a symbol starting from a given time.

Returns up to numberOfCandles (max 50) OHLCV candles with openTime ≥ the provided start time, ordered by openTime ascending. The optional interval query parameter sets the candle size (same values as GET /v4/data/rate/symbol/OHLCV); it defaults to 1m.

Supported symbols: We support 439+ trading pairs. The symbol parameter accepts the base currency (e.g., "BTC", "ETH").

Time format: Provide the start of the range either as a Unix timestamp in milliseconds (unixFrom) or as a Date in ISO 8601 format (timeFrom). You must provide exactly one of these parameters.

get/v4/data/rate/symbol/OHLCV/batch

Query parameters

symbol'BTC' | 'ETH' | 'BNB' | 'NEO' | 'LTC' | 'QTUM' | 'ADA' | 'XRP' | 'TUSD' | 'IOTA' | 'XLM' | 'ONT' | 'TRX' | 'ETC' | 'ICX' | 'VET' | 'USDC' | 'LINK' | 'ONG' | 'HOT' | 'ZIL' | 'ZRX' | 'FET' | 'BAT' | 'ZEC' | 'IOST' | 'CELR' | 'DASH' | 'THETA' | 'ENJ' | 'ATOM' | 'TFUEL' | 'ONE' | 'ALGO' | 'DOGE' | 'DUSK' | 'ANKR' | 'WIN' | 'COS' | 'MTL' | 'DENT' | 'WAN' | 'FUN' | 'CVC' | 'CHZ' | 'BAND' | 'XTZ' | 'RVN' | 'HBAR' | 'NKN' | 'STX' | 'KAVA' | 'ARPA' | 'IOTX' | 'RLC' | 'BCH' | 'FTT' | 'EUR' | 'OGN' | 'LSK' | 'BNT' | 'MBL' | 'COTI' | 'DATA' | 'SOL' | 'CTSI' | 'HIVE' | 'CHR' | 'ARDR' | 'MDT' | 'KNC' | 'LRC' | 'COMP' | 'SC' | 'ZEN' | 'SNX' | 'VTHO' | 'DGB' | 'SXP' | 'DCR' | 'STORJ' | 'MANA' | 'YFI' | 'JST' | 'CRV' | 'SAND' | 'NMR' | 'DOT' | 'LUNA' | 'RSR' | 'PAXG' | 'TRB' | 'SUSHI' | 'KSM' | 'EGLD' | 'DIA' | 'RUNE' | 'FIO' | 'UMA' | 'BEL' | 'UNI' | 'OXT' | 'SUN' | 'AVAX' | 'UTK' | 'XVS' | 'AAVE' | 'NEAR' | 'FIL' | 'INJ' | 'AUDIO' | 'CTK' | 'AXS' | 'STRAX' | 'ROSE' | 'AVA' | 'SKL' | 'GRT' | 'JUV' | 'PSG' | '1INCH' | 'OG' | 'ATM' | 'ASR' | 'CELO' | 'RIF' | 'TRU' | 'CKB' | 'TWT' | 'SFP' | 'DODO' | 'CAKE' | 'ACM' | 'FIS' | 'OM' | 'POND' | 'DEGO' | 'ALICE' | 'SUPER' | 'CFX' | 'TKO' | 'PUNDIX' | 'TLM' | 'BAR' | 'FORTH' | 'SLP' | 'SHIB' | 'ICP' | 'AR' | 'MASK' | 'LPT' | 'XVG' | 'ATA' | 'GTC' | 'PHA' | 'MLN' | 'DEXE' | 'C98' | 'QNT' | 'FLOW' | 'MINA' | 'RAY' | 'FARM' | 'QUICK' | 'MBOX' | 'REQ' | 'GHST' | 'WAXP' | 'GNO' | 'XEC' | 'DYDX' | 'IDEX' | 'USDP' | 'GALA' | 'ILV' | 'YGG' | 'SYS' | 'DF' | 'FIDA' | 'AGLD' | 'RAD' | 'RARE' | 'LAZIO' | 'CHESS' | 'ADX' | 'AUCTION' | 'MOVR' | 'CITY' | 'ENS' | 'QI' | 'PORTO' | 'POWR' | 'JASMY' | 'AMP' | 'PYR' | 'ALCX' | 'SANTOS' | 'BICO' | 'FLUX' | 'FXS' | 'VOXEL' | 'HIGH' | 'CVX' | 'PEOPLE' | 'SPELL' | 'JOE' | 'ACH' | 'IMX' | 'GLMR' | 'SCRT' | 'API3' | 'BTTC' | 'ACA' | 'XNO' | 'WOO' | 'ALPINE' | 'T' | 'ASTR' | 'GMT' | 'APE' | 'BIFI' | 'STEEM' | 'NEXO' | 'REI' | 'LDO' | 'OP' | 'STG' | 'LUNC' | 'GMX' | 'POLYX' | 'APT' | 'OSMO' | 'HFT' | 'PHB' | 'HOOK' | 'MAGIC' | 'RP' | 'GNS' | 'SYN' | 'SSV' | 'LQTY' | 'USTC' | 'GAS' | 'GLM' | 'PROM' | 'QKC' | 'ID' | 'ARB' | 'RDNT' | 'WBTC' | 'EDU' | 'SUI' | 'PEPE' | 'FLOKI' | 'MAV' | 'PENDLE' | 'ARKM' | 'WBETH' | 'WLD' | 'FDUSD' | 'SEI' | 'CYBER' | 'ARK' | 'IQ' | 'NTRN' | 'TIA' | 'MEME' | 'ORDI' | 'BEAMX' | 'PIVX' | 'VIC' | 'BLUR' | 'VANRY' | 'AEUR' | 'JTO' | '1000SATS' | 'BONK' | 'ACE' | 'NFP' | 'AI' | 'XAI' | 'MANTA' | 'ALT' | 'JUP' | 'PYTH' | 'RONIN' | 'DYM' | 'PIXEL' | 'STRK' | 'PORTAL' | 'AXL' | 'WIF' | 'METIS' | 'AEVO' | 'BOME' | 'ETHFI' | 'ENA' | 'W' | 'TNSR' | 'SAGA' | 'TAO' | 'REZ' | 'BB' | 'NOT' | 'IO' | 'ZK' | 'LISTA' | 'ZRO' | 'G' | 'BANANA' | 'RENDER' | 'TON' | 'DOGS' | 'EURI' | 'POL' | 'NEIRO' | 'TURBO' | '1MBABYDOGE' | 'CATI' | 'HMSTR' | 'EIGEN' | 'SCR' | 'BNSOL' | 'LUMIA' | 'KAIA' | 'COW' | 'CETUS' | 'PNUT' | 'ACT' | 'USUAL' | 'THE' | 'ACX' | 'ORCA' | 'MOVE' | 'ME' | 'VELODROME' | 'VANA' | '1000CAT' | 'PENGU' | 'BIO' | 'D' | 'AIXBT' | 'CGPT' | 'COOKIE' | 'S' | 'SOLV' | 'TRUMP' | 'ANIME' | 'BERA' | '1000CHEEMS' | 'TST' | 'LAYER' | 'HEI' | 'KAITO' | 'SHELL' | 'RED' | 'GPS' | 'EPIC' | 'BMT' | 'FORM' | 'XUSD' | 'NIL' | 'PARTI' | 'MUBARAK' | 'TUT' | 'BROCCOLI714' | 'BANANAS31' | 'GUN' | 'BABY' | 'ONDO' | 'BIGTIME' | 'VIRTUAL' | 'KERNEL' | 'WCT' | 'HYPER' | 'INIT' | 'SIGN' | 'STO' | 'SYRUP' | 'KMNO' | 'SXT' | 'NXPC' | 'AWE' | 'HAEDAL' | 'USD1' | 'HUMA' | 'A' | 'SOPH' | 'RESOLV' | 'HOME' | 'SPK' | 'NEWT' | 'SAHARA' | 'LA' | 'ERA' | 'C' | 'TREE' | 'A2Z' | 'TOWNS' | 'PROVE' | 'BFUSD' | 'PLUME' | 'DOLO' | 'MITO' | 'WLFI' | 'SOMI' | 'OPEN' | 'USDE' | 'LINEA' | 'HOLO' | 'PUMP' | 'AVNT' | 'ZKC' | 'SKY' | 'BARD' | '0G' | 'HEMI' | 'XP' | 'MIRA' | 'FF' | 'EDEN' | 'NOM' | '2Z' | 'MORPH' | 'ASTER' | 'WAL' | 'EUL' | 'ENSO' | 'YB' | 'ZBT' | 'TURTLE' | 'GIGGLE' | 'F' | 'KITE' | 'MMT' | 'SAPIEN' | 'ALLO' | 'BANK' | 'MET' required

Enum for trading pair symbols used in historical prices. These are the base symbols that are supported for historical price queries.

Example:BTC

The base symbol of the trading pair (e.g., "BTC", "ETH").

unixFrominteger

Example:1609459200000

Start time as Unix timestamp in milliseconds. Either <code>unixFrom</code> or <code>timeFrom</code> must be provided, but not both.

timeFromstring date-time

Example:2021-01-01T00:00:00Z

Start time in ISO 8601 format. Either <code>unixFrom</code> or <code>timeFrom</code> must be provided, but not both.

numberOfCandlesinteger required

Example:10

Number of candles to return (1 to 50).

interval'1m' | '5m' | '15m' | '30m' | '45m' | '1h' | '2h' | '4h' | '1d' | '1w' | '1M'

Candle interval. Supported values: 1m, 5m, 15m, 30m, 45m, 1h, 2h, 4h, 1d, 1w, 1M. Defaults to 1m.

Response

OK - Returns up to numberOfCandles OHLCV records starting from the given time.

symbolstring required

Base symbol of the trading pair without (e.g., "BTC").

openTimenumber required

Kline open time in milliseconds (Unix timestamp).

openstring required

Open price.

highstring required

High price.

lowstring required

Low price.

closestring required

Close price.

closeTimenumber required

Kline close time in milliseconds (Unix timestamp).

volumestring required

Base asset volume.

quoteAssetVolumestring required

Quote asset volume (USDT).

numberOfTradesnumber required

Number of trades.

takerBuyBaseAssetVolumestring required

Taker buy base asset volume.

takerBuyQuoteAssetVolumestring required

Taker buy quote asset volume.

Example response

[
  {
    "symbol": "BTC",
    "openTime": 1499040000000,
    "open": "0.01634790",
    "high": "0.80000000",
    "low": "0.01575800",
    "close": "0.01577100",
    "closeTime": 1499644799999,
    "volume": "148976.11427815",
    "quoteAssetVolume": "2434.19055334",
    "numberOfTrades": 308,
    "takerBuyBaseAssetVolume": "1756.87402397",
    "takerBuyQuoteAssetVolume": "28.46694368"
  }
]