Get coin OHLC

professional This endpoint requires the professional plan or higher

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

GET /coin/:uuid/ohlc

Path parameters

uuid StringUUID of the coin you want to request the OHLC 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

limit (optional) Number

Limit. Limit the amount of time periods for which the OHLC 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

referenceCurrencyUuid (optional) String

UUID of reference currency, in which all the prices are calculated. Defaults to US Dollar.

Default value: yhjMzLPhuIDl


Code examples


HTTP/1.1 200 OK
  "status": "success",
  "data": {
    "ohlc": [
        "startingAt": 1641427200,
        "open": "43639.170052896734",
        "high": "43830.15844443845",
        "low": "42679.105282492994",
        "close": "43253.82606224523",
        "avg": "43194.86335084649"
        "startingAt": 1641340800,
        "open": "45997.97595190101",
        "high": "47050.58243007133",
        "low": "42923.375181467185",
        "close": "43639.198327313374",
        "avg": "46022.85506904964"

Response fields

status String

Status of the request

Allowed values:
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. String/null

Opening price of the coin for the time period

data.ohlc.high String/null

Highest price of the coin during the time period

data.ohlc.low String/null

Lowest price of the coin during the time period

data.ohlc.close String/null

Closing price of the coin for the time period

data.ohlc.avg String/null

Average price of the coin over the time period

Error response

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

Error responses