Get coin OHLCV

professional This endpoint requires the professional plan or higher

Get OHLCV (Open High Low Close Volume) data for the coin throughout time.

https://api.coinranking.com/v2/coin/:uuid/ohlcv

Path parameters

ParameterDescription
uuid StringUUID of the coin you want to request the OHLCV data for.

Query parameters

Parameter Description
interval (optional) String

The interval determines the time period over which each OHLC item is determined.

Default value: day
Allowed values:
minute 5minutes hour 8hours day week month

Example:
...coin/Qwsogvtv82FCd/ohlcv?interval=hour
limit (optional) Number

Limit. Limit the amount of time periods for which the OHLCV data is retrieved. For example, when interval=hour and limit is 10, data will be returned for the last 10 hours. The maximum amount of results you can fetch in one request is 5000 for the Startup and Professional plan, and 100 for the Free plan.

Default value: 50
Size range: 0-5000


Example:
...coin/Qwsogvtv82FCd/ohlcv?limit=10
referenceCurrencyUuid (optional) String

UUID of coin (either fiat or crypto), in which all the prices are calculated. Defaults to US Dollar, but you can use any coin. You can find UUIDs for reference currencies in any coin endpoint, including a convenient dedicated reference currency endpoint

Note: When using a reference currency, the OHLC values are converted from USD-based calculations rather than recalculated from raw trading data. Since reference currency exchange rates fluctuate during the time period this means:

  • The Open or Close values might be higher than the High or lower than the Low
  • For true OHLC data in a specific currency pair, use USD as the reference currency or subscribe to the realtime rates for both the coin and the intended reference currency and calculate the OHLC values yourself
Default value: yhjMzLPhuIDl

Example:
...coin/Qwsogvtv82FCd/ohlcv?referenceCurrencyUuid=5k-_VTxqtCEI

Code examples

Response

json
HTTP/1.1 200 OK { "status": "success", "data": { "ohlc": [ { "startingAt": 1733011200, "endingAt": 1735689600, "open": "96447.1775503152", "high": "108201.88415847138", "low": "91546.14889956331", "close": "92757.25601337428", "avg": "98498.05461116068", "24hVolume": "46442676990.360725", "intervalVolume": "2002368626068.8618" }, { "startingAt": 1730419200, "endingAt": 1733011200, "open": "70322.96990325804", "high": "99588.89995964085", "low": "66922.19464691161", "close": "96449.1102387863", "avg": "86276.37524878597", "24hVolume": "38017759048.21358", "intervalVolume": "3928981914099.0195" } ] } }

Response fields

PropertyDescription
status String

Status of the request

Allowed values:
success
data Object
data.ohlc Object[]

List of OHLC items

data.ohlc.startingAt Number

An Epoch timestamp in seconds marking the start of the time period on which the OHLC values are based.

data.ohlc.open String/null

Opening price of the coin for the time period in the reference currency

data.ohlc.high String/null

Highest USD price of the coin during the time period in the reference currency. When using non-USD reference currencies, the highest USD price is directly converted to the reference currency. Since the reference currency itself can fluctuate against the US Dollar, the High is not necessarily the highest price in the chosen reference currency.

data.ohlc.low String/null

Lowest USD price of the coin during the time period in the reference currency. When using non-USD reference currencies, the lowest USD price is directly converted to the reference currency. Since the reference currency itself can fluctuate against the US Dollar, the Low is not necessarily the lowest price in the chosen reference currency.

data.ohlc.close String/null

Closing price of the coin for the time period in the reference currency

data.ohlc.avg String/null

Average price of the coin over the time period

data.ohlc.24hVolume String/null

Total 24h volume of the coin in the reference currency

data.ohlc.intervalVolume String/null

Total volume of the coin for the specified time interval in the reference currency. This field is only applicable for intervals of week and month; otherwise, it will be null

Error response

json
HTTP/1.1 404 Not Found { "status": "fail", "type": "COIN_NOT_FOUND", "message": "Coin not found" }

Error responses