/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
timeFromandtimeToto calculate price change over a specific period. Both parameters must be in ISO 8601 date-time format. - Interval-based: Provide an
intervalparameter (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.
Bad Request - Invalid parameters (e.g., both time range and interval provided, or neither provided, or invalid symbol, or timeTo not greater than timeFrom).
Forbidden. The request is authenticated, but it is not possible to required perform operation due to logical error or invalid permissions.
Not Found - No price data found for the requested symbol and time range/interval.