v1
latestOpenAPI 3.1.02026-07-243035381.4 MBExchange rate
Get Price Change by Symbol
/v4/data/rate/price-change
200 credits per API call
Get price change data for a symbol over a specified time range or interval.
This endpoint calculates the price change (both absolute and percentage) for a given symbol between two points in time. You can either specify an explicit time range using timeFrom and timeTo, or use a predefined interval that computes the change from the last fully closed candle.
Supported symbols: We support 439+ trading pairs. The symbol parameter accepts the base currency (e.g., "BTC", "ETH").
Base pair: By default, the base pair is "USDT". You can specify a different quote asset (e.g., "ETH", "USDC") using the basePair parameter.
Time range options:
- Explicit time range: Provide both timeFrom and timeTo to calculate price change over a specific period. Both parameters must be in ISO 8601 date-time format.
- Interval-based: Provide an interval parameter (e.g., "1h", "1d", "1w", "1M") to calculate price change from the last fully closed candle of that interval. Supported intervals: 1m, 5m, 15m, 30m, 45m, 1h, 2h, 4h, 1d, 1w, 1M, 1y.
Important: You must provide either (timeFrom + timeTo) OR interval, but not both.
get/v4/data/rate/price-change
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").
basePair'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'
Enum for trading pair symbols used in historical prices. These are the base symbols that are supported for historical price queries.
Example:BTC
Quote asset (e.g., "USDT", "ETH"). Defaults to "USDT" when not provided.
timeFromstring date-time
Range start (ISO 8601 date-time). Must be provided together with <code>timeTo</code> if not using <code>interval</code>.
timeTostring date-time
Range end (ISO 8601 date-time). Must be provided together with <code>timeFrom</code> if not using <code>interval</code>. Must be greater than <code>timeFrom</code>.
interval'1m' | '5m' | '15m' | '30m' | '45m' | '1h' | '2h' | '4h' | '1d' | '1w' | '1M' | '1y'
Interval computed from the last fully closed candle (e.g. "1h", "1d", "1w", "1M"). Must be provided if not using <code>timeFrom</code> and <code>timeTo</code>.
Response
OK - Returns price change data for the requested symbol and time range/interval.
Example response
{
"symbol": "BTC",
"basePair": "USDT",
"open": "45000.50",
"close": "46500.75",
"openTime": 1704067200000,
"closeTime": 1704153600000,
"absoluteChange": "1500.25",
"percentageChange": 3.33,
"batchId": "one"
}