Bitcoin Candles API

Binance spot BTC/USDT OHLCV candles: 5 minute, 1 hour, and 1 day.

History from 2017-08-17. Only closed candles are stored and served. Prices and quote volume are quoted in USDT, not USD.

How to call

Request format

GET only 
curl -X GET "https://newhedge.io/api/v2/candles/btc?interval=1d&api_token=YOUR_TOKEN"
curl -X GET "https://newhedge.io/api/v2/candles/btc?interval=1h&api_token=YOUR_TOKEN"
curl -X GET "https://newhedge.io/api/v2/candles/btc?interval=5m&api_token=YOUR_TOKEN"
Query params

api_token (required): 24 character API token. interval (required): one of 5m, 1h, 1d.

Optional query

venue: default and only value today is binance. before: exclusive epoch-ms cursor. limit: page size, default and max 1000.

include: definition wraps the response as {"definition": …, "data": …} and returns the record for the requested interval; see Definitions.

Responses

200 on success, 400 for an invalid interval or an unknown include value, 401 for missing/invalid token, an unpermitted interval, or monthly limit reached, 404 for an unknown venue.

1d is available to any authenticated token. 5m and 1h require an Advanced or enterprise token.

Endpoint

BTC/USDT Candles: 5m

Rows are [open_time, open, high, low, close, volume, close_time, quote_volume, trade_count], ascending by open_time.

Endpoint 
https://newhedge.io/api/v2/candles/btc?interval=5m&api_token=YOUR_TOKEN

Replace YOUR_TOKEN with your API token.

Sample response
200 Successful response 
[
  [
    1789405200000,
    78769.42,
    78820.01,
    78734.96,
    78810.0,
    28.193,
    1789405499999,
    2220933.565246,
    7110
  ],
  [
    1789405500000,
    78810.01,
    78890.01,
    78750.0,
    78804.01,
    33.22019,
    1789405799999,
    2618432.9597589,
    7606
  ],
  [
    1789405800000,
    78804.01,
    78832.01,
    78782.0,
    78828.01,
    42.83853,
    1789406099999,
    3376177.6372985,
    6466
  ]
]
Definition

Value: OHLCV candle for the Binance spot BTC/USDT market: open, high, low, and close in USDT, base volume in BTC, quote volume in USDT, and trade count. Row order: [open_time_ms, open, high, low, close, volume_btc, close_time_ms, quote_volume_usdt, trade_count].

Units: usdt. Quote currency is USDT, not USD; no USD conversion is applied to this series

Timestamp: open_time is the candle's opening instant in UTC milliseconds; close_time is the last millisecond of the candle. Only closed candles are stored and served.

Calendar: intraday

Revision policy: never. A stored candle is never overwritten.

Universe: Binance spot BTC/USDT; history from 2017-08-17.

Methodology version: 2026-09-06

Endpoint

BTC/USDT Candles: 1h

Rows are [open_time, open, high, low, close, volume, close_time, quote_volume, trade_count], ascending by open_time.

Endpoint 
https://newhedge.io/api/v2/candles/btc?interval=1h&api_token=YOUR_TOKEN

Replace YOUR_TOKEN with your API token.

Sample response
200 Successful response 
[
  [
    1789394400000,
    78168.01,
    78712.29,
    78164.01,
    78521.06,
    1305.24797,
    1789397999999,
    102452583.0986147,
    277802
  ],
  [
    1789398000000,
    78521.05,
    78684.01,
    78301.41,
    78578.02,
    911.75735,
    1789401599999,
    71566976.27363341,
    224966
  ],
  [
    1789401600000,
    78578.02,
    78904.72,
    78426.17,
    78769.42,
    663.13004,
    1789405199999,
    52191987.2355967,
    143413
  ]
]
Definition

Value: OHLCV candle for the Binance spot BTC/USDT market: open, high, low, and close in USDT, base volume in BTC, quote volume in USDT, and trade count. Row order: [open_time_ms, open, high, low, close, volume_btc, close_time_ms, quote_volume_usdt, trade_count].

Units: usdt. Quote currency is USDT, not USD; no USD conversion is applied to this series

Timestamp: open_time is the candle's opening instant in UTC milliseconds; close_time is the last millisecond of the candle. Only closed candles are stored and served.

Calendar: intraday

Revision policy: never. A stored candle is never overwritten.

Universe: Binance spot BTC/USDT; history from 2017-08-17.

Methodology version: 2026-09-06

Endpoint

BTC/USDT Candles: 1d

Rows are [open_time, open, high, low, close, volume, close_time, quote_volume, trade_count], ascending by open_time.

Endpoint 
https://newhedge.io/api/v2/candles/btc?interval=1d&api_token=YOUR_TOKEN

Replace YOUR_TOKEN with your API token.

Sample response
200 Successful response 
[
  [
    1789084800000,
    76568.73,
    79890.0,
    76046.58,
    77225.7,
    19713.27729,
    1789171199999,
    1528809492.099309,
    3614263
  ],
  [
    1789171200000,
    77225.71,
    77505.67,
    77059.75,
    77278.73,
    8060.44455,
    1789257599999,
    622849159.587739,
    748574
  ],
  [
    1789257600000,
    77278.73,
    77450.0,
    76500.0,
    76842.01,
    6959.68366,
    1789343999999,
    536092213.4014395,
    1275503
  ]
]
Definition

Value: OHLCV candle for the Binance spot BTC/USDT market: open, high, low, and close in USDT, base volume in BTC, quote volume in USDT, and trade count. Row order: [open_time_ms, open, high, low, close, volume_btc, close_time_ms, quote_volume_usdt, trade_count].

Units: usdt. Quote currency is USDT, not USD; no USD conversion is applied to this series

Timestamp: open_time is the candle's opening instant in UTC milliseconds; close_time is the last millisecond of the candle. Only closed candles are stored and served.

Calendar: calendar_daily

Revision policy: never. A stored candle is never overwritten.

Universe: Binance spot BTC/USDT; history from 2017-08-17.

Methodology version: 2026-09-06

Errors

Error responses

400

{"error":"interval must be one of 5m, 1h, 1d"}

401

{"error":"Token is required"}, {"error":"Invalid token"}, {"error":"interval 5m requires an Advanced or enterprise token"}, or {"error":"Monthly API calls limit reached"}.

404

{"error":"Venue not found"} when venue is not binance.