/v4/data/rate/symbol/OHLCV
50 credits per API call
Get historical exchange rate in USD for a symbol at a specific point in time.
This endpoint retrieves the closest available price record for a given symbol and timestamp. The data includes OHLCV (Open, High, Low, Close, Volume). By default returns 1-minute candles; use the interval parameter to aggregate into 5m, 15m, 1h, 1d, etc.
Supported symbols: We support 439+ trading pairs. The symbol parameter accepts the base currency (e.g., "BTC", "ETH").
Time handling:
- If you provide a time, we return the OHLCV record where the time falls within its interval (
openTime≤ time <closeTime), or the closest available record if no exact match is found. - If you provide a time that is later than any available data, we return the most recent OHLCV record we have.
- If you provide a time that is earlier than any available data, we return the earliest available OHLCV record.
Time format: You can provide time either as a Unix timestamp in milliseconds (using the unix parameter) or as a Date object (using the time parameter). You must provide exactly one of these parameters.
Interval: Candle interval. Supported values: 1m, 5m, 15m, 30m, 45m, 1h, 2h, 4h, 1d, 1w, 1M. Defaults to 1m.
Bad Request - Invalid parameters (e.g., both unix and time provided, or neither provided, or invalid symbol).
Forbidden. The request is authenticated, but it is not possible to required perform operation due to logical error or invalid permissions.
Not Found - No historical price data found for the requested symbol.