Sign in

v1

latestOpenAPI 3.1.02026-07-243035381.4 MB
Exchange rate

Get Price Change by Symbol - Batch

/v4/data/rate/price-change/batch

200 credits per API call

Get price change data for multiple symbols in a single request. Each item may specify a time range (timeFrom + timeTo) or an interval. Maximum 10 items per request.

Request body must be an array of objects (or { "body": [ ... ] }). Each object must include symbol, batchId, and either (timeFrom + timeTo) or interval.

post/v4/data/rate/price-change/batch

Request body

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.

basePairstring

Quote asset (e.g., "USDT", "ETH"). Defaults to "USDT".

timeFromstring date-time

Range start (ISO 8601). Required if not using interval.

timeTostring date-time

Range end (ISO 8601). Required if not using interval.

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

Predefined interval (e.g. "1h", "1d", "1w", "1M"). Use instead of timeFrom/timeTo.

batchIdstring required

Client-defined id returned with the result for this item.

Example request

[
  {
    "symbol": "BTC",
    "basePair": "USDT",
    "batchId": "one"
  }
]

Response

OK - Returns price change data for each requested item; each result includes the corresponding <code>batchId</code>.

symbolstring required

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

basePairstring required

Quote asset of the trading pair (e.g., "USDT", "ETH").

openstring required

Opening price at the start of the time range/interval.

closestring required

Closing price at the end of the time range/interval.

openTimenumber required

Opening time in milliseconds (Unix timestamp).

closeTimenumber required

Closing time in milliseconds (Unix timestamp).

absoluteChangestring required

Absolute price change (close - open) as a string.

percentageChangenumber double required

Percentage price change as a number.

batchIdstring

Echoed from the request for identification.

Example response

[
  {
    "symbol": "BTC",
    "basePair": "USDT",
    "open": "45000.50",
    "close": "46500.75",
    "openTime": 1704067200000,
    "closeTime": 1704153600000,
    "absoluteChange": "1500.25",
    "percentageChange": 3.33,
    "batchId": "one"
  }
]