OHLC Candlesticks

This is the data that is shown in our charting interface.

get
Market OHLC

https://api.cryptowat.ch/markets/:exchange/:pair/ohlc
Returns a market's OHLC candlestick data. A series of candlesticks is represented as a list of lists of numbers.
Request
Response
Request
Path Parameters
exchange
required
string
Exchange symbol
pair
required
string
Pair symbol
Query Parameters
before
optional
integer
Unix timestamp. Only return candles opening before this time. Example: 1481663244
after
optional
integer
Unix timestamp. Only return candles opening after this time. Example 1481663244
periods
optional
array
Comma separated integers. Only return these time periods. Example: 60,180,108000
Response
200: OK
https://api.cryptowat.ch/markets/kraken/btceur/ohlc
{
"result": {
"14400": [
[
1567555200,
9727.3,
9788.9,
9414.2,
9690.8,
888.92215493,
8601704.133826157
],
[
1567569600,
9692.9,
9693.4,
9525,
9685.1,
281.73395575,
2705497.370853147
],
// …
],
"180": [
[
1574640720,
6223.3,
6240.9,
6201,
6240.6,
24.41446606,
151899.316789675
],
[
1574640900,
6247.2,
6261.5,
6226.3,
6229,
17.64013272,
110326.682797803
],
// …
]
}
}

1-minute candles are under the "60" key. 3-minute are "180", and so on.

The values are in this order:

[
CloseTime,
OpenPrice,
HighPrice,
LowPrice,
ClosePrice,
Volume,
QuoteVolume
]

So for instance, we can take this string value under Coinbase Pro's BTCUSD market for time period "3600" (1-hour):

[
1573552800,
8744,
8756.1,
8710,
8753.5,
91.58314308,
799449.488966417
],

This represents a 1-hour candle starting at 1474732800 (Sat, 24 Sep 2016 16:00:00 GMT) and ending at 1573552800 (Tue, 12 Nov 2019 10:00:00 GMT).

The open price for this candle is 8744, the high price 8756.1, the low price 8710, and the close price 8753.5. The volume for this candle was 91.58314308 denominated in BTC, and 799449.488966417 denominated in USD.

Period values

Value

Label

60

1m

180

3m

300

5m

900

15m

1800

30m

3600

1h

7200

2h

14400

4h

21600

6h

43200

12h

86400

1d

259200

3d

604800

1w