Sign in

v1

latestOpenAPI 3.1.02026-07-243035381.4 MB
Exchange rate

Get OHLCV by Symbol

/v4/data/rate/symbol/OHLCV

50 credits per API call

Get historical exchange rate in USD for a symbol at a specific point in time.

This endpoint retrieves the closest available price record for a given symbol and timestamp. The data includes OHLCV (Open, High, Low, Close, Volume). By default returns 1-minute candles; use the interval parameter to aggregate into 5m, 15m, 1h, 1d, etc.

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

Time handling:

  • If you provide a time, we return the OHLCV record where the time falls within its interval (openTime ≤ time < closeTime), or the closest available record if no exact match is found.
  • If you provide a time that is later than any available data, we return the most recent OHLCV record we have.
  • If you provide a time that is earlier than any available data, we return the earliest available OHLCV record.

Time format: You can provide time either as a Unix timestamp in milliseconds (using the unix parameter) or as a Date object (using the time parameter). You must provide exactly one of these parameters.

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

get/v4/data/rate/symbol/OHLCV

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").

unixinteger
Example:1609459200000

Unix timestamp in milliseconds. Either <code>unix</code> or <code>time</code> must be provided, but not both.

timestring date-time
Example:2021-01-01T00:00:00Z

Date object in ISO 8601 format. Either <code>unix</code> or <code>time</code> must be provided, but not both.

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 the closest available historical price record for the requested symbol and 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"
}