--- title: "Get Price Change by Symbol" method: GET path: "/v4/data/rate/price-change" tags: ["Exchange rate"] --- # Get Price Change by Symbol `GET /v4/data/rate/price-change` /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. ## 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. - `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. - `timeFrom` string, date-time - `timeTo` string, date-time - `interval` '1m' | '5m' | '15m' | '30m' | '45m' | '1h' | '2h' | '4h' | '1d' | '1w' | '1M' | '1y' ## Response `200` OK - Returns price change data for the requested symbol and time range/interval. - PriceChangeResponse — Price change data for a trading pair over a specified time range or interval. Includes open and close prices, timestamps, and calculated absolute and percentage changes. - `symbol` string, required — Base symbol of the trading pair (e.g., "BTC"). - `basePair` string, required — Quote asset of the trading pair (e.g., "USDT", "ETH"). - `open` string, required — Opening price at the start of the time range/interval. - `close` string, required — Closing price at the end of the time range/interval. - `openTime` number, required — Opening time in milliseconds (Unix timestamp). - `closeTime` number, required — Closing time in milliseconds (Unix timestamp). - `absoluteChange` string, required — Absolute price change (close - open) as a string. - `percentageChange` number, double, required — Percentage price change as a number. - `batchId` string — Echoed from the request for identification. ## Other responses - `400` — Bad Request - Invalid parameters (e.g., both time range and interval provided, or neither provided, or invalid symbol, or timeTo not greater than timeFrom). - `401` — Unauthorized. Not valid or inactive subscription key present in the HTTP Header. - `403` — Forbidden. The request is authenticated, but it is not possible to required perform operation due to logical error or invalid permissions. - `404` — Not Found - No price data found for the requested symbol and time range/interval. - `500` — Internal server error. There was an error on the server during the processing of the request. --- [API](https://skmtc.net/tatum/apis/blockchain-data.md) · [All operations](https://skmtc.net/tatum/apis/blockchain-data/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tatum/blockchain-data/revisions/8622ee4b8fae/schema)