/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: Optional candle interval. When provided, aggregates 1-minute candles into the requested interval (OHLCV: open=first, high=max, low=min, close=last, volume=sum). Supported values: 1m, 5m, 15m, 30m, 45m, 1h, 2h, 4h, 1d, 1w, 1M. Defaults to 1m when not provided.