Get Price Change by Symbol

/v4/data/rate/price-change

50 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") 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, 1y.

Important: You must provide either (timeFrom + timeTo) OR interval, but not both.