Bitcoin Price API

Live prices, historical prices, and OHLC candles.

Fetch daily historical BTC prices or the latest live price. Add an optional currency query parameter to convert USD values to supported fiat currencies.

View Live Bitcoin Price Data on Newhedge External link

How to call

Request format

GET only 
curl -X GET "https://newhedge.io/api/v2/price/historical?api_token=YOUR_TOKEN"
curl -X GET "https://newhedge.io/api/v2/price/historical?api_token=YOUR_TOKEN&currency=GBP"
curl -X GET "https://newhedge.io/api/v2/price/live?api_token=YOUR_TOKEN"
curl -X GET "https://newhedge.io/api/v2/price/live?api_token=YOUR_TOKEN&currency=EUR"
Query params

api_token (required) — 24 character API token.

Optional query

currency — fiat currency code from your CurrencyRate.name list (for example EUR).

include — /api/v2/price/historical only. definition wraps the response as {"definition": …, "data": …} and returns the btc_daily_price record below; see Definitions.

Responses

200 on success, 400 for an unknown include value, 401 for missing/invalid token or monthly limit reached, 404 when the provided currency is not found.

Available currencies (164)

AED, AFN, ALL, AMD, ANG, AOA, ARS, AUD, AWG, AZN, BAM, BBD, BDT, BGN, BHD, BIF, BMD, BND, BOB, BRL, BSD, BTN, BWP, BYN, BZD, CAD, CDF, CHF, CLF, CLP, CNY, COP, CRC, CUC, CUP, CVE, CZK, DJF, DKK, DOP, DZD, EGP, ERN, ETB, EUR, FJD, FKP, GBP, GEL, GGP, GHS, GIP, GMD, GNF, GTQ, GYD, HKD, HNL, HRK, HTG, HUF, IDR, ILS, IMP, INR, IQD, IRR, ISK, JEP, JMD, JOD, JPY, KES, KGS, KHR, KMF, KPW, KRW, KWD, KYD, KZT, LAK, LBP, LKR, LRD, LSL, LTL, LVL, LYD, MAD, MDL, MGA, MKD, MMK, MNT, MOP, MUR, MVR, MWK, MXN, MYR, MZN, NAD, NGN, NIO, NOK, NPR, NZD, OMR, PAB, PEN, PGK, PHP, PKR, PLN, PYG, QAR, RON, RSD, RUB, RWF, SAR, SBD, SCR, SDG, SEK, SGD, SHP, SLL, SOS, SRD, STD, SVC, SYP, SZL, THB, TJS, TMT, TND, TOP, TRY, TTD, TWD, TZS, UAH, UGX, UYU, UZS, VES, VND, VUV, WST, XAF, XAG, XAU, XCD, XDR, XOF, XPF, YER, ZAR, ZMW, ZWG, ZWL

Endpoint

Bitcoin Historical Price

Returns daily BTC price history as an array of [timestamp, price] pairs.

Endpoint 
https://newhedge.io/api/v2/price/historical?api_token=YOUR_TOKEN

Optional conversion: append &currency=EUR. Replace YOUR_TOKEN with your API token.

Sample response
200 Successful response 
[
  [
    1790640000000,
    83448.96
  ],
  [
    1790726400000,
    83644.8
  ],
  [
    1790812800000,
    83547.16
  ],
  [
    1790899200000,
    84782.83
  ],
  [
    1790985600000,
    84496.6
  ]
]
Definition

Every point is one btc_daily_price sample.

Value: Daily Bitcoin reference price in US dollars, sampled once per day at 00:00 UTC from the Newhedge spot price aggregate.

Units: usd (before any currency conversion)

Timestamp: Labelled 00:00 UTC of the day of the sample. Missing days are backfilled; a stored day is never overwritten.

Calendar: calendar_daily

Revision policy: append_only. A stored day is never overwritten.

Universe: Major spot exchanges.

Methodology version: 2026-09-06

Endpoint

Bitcoin Live Price

Returns the latest available BTC price. This endpoint updates every minute.

Endpoint 
https://newhedge.io/api/v2/price/live?api_token=YOUR_TOKEN

Optional conversion: append &currency=EUR.

Sample response
200 Successful response 
{
  "price": 84569.39
}

With currency=EUR:

{
  "price": 75157.07
}
Errors

Price endpoint errors

400

{"error":"include must be one of definition"} when include carries any other value.

401

{"error":"Token is required"}, {"error":"Invalid token"}, or {"error":"Monthly API calls limit reached"}.

404

{"error":"Currency not found"} when currency does not match a saved currency code.

OHLC candles

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 
[
  [
    1791019500000,
    84610.0,
    84610.01,
    84598.05,
    84598.06,
    17.24762,
    1791019799999,
    1459292.9804347,
    1123
  ],
  [
    1791019800000,
    84598.06,
    84598.06,
    84591.42,
    84591.43,
    11.53282,
    1791020099999,
    975607.6780833,
    934
  ],
  [
    1791020100000,
    84591.43,
    84591.43,
    84590.0,
    84590.0,
    9.77901,
    1791020399999,
    827208.2386939001,
    1079
  ]
]
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 
[
  [
    1791007200000,
    84652.09,
    84674.01,
    84550.0,
    84586.0,
    272.31113,
    1791010799999,
    23047069.8291262,
    32485
  ],
  [
    1791010800000,
    84586.01,
    84648.01,
    84560.0,
    84560.0,
    376.02149,
    1791014399999,
    31811808.5229634,
    37935
  ],
  [
    1791014400000,
    84560.0,
    84644.47,
    84557.36,
    84616.01,
    244.08048,
    1791017999999,
    20651619.0172338,
    28365
  ]
]
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 
[
  [
    1790726400000,
    83663.66,
    85649.95,
    82956.11,
    83623.6,
    18522.82001,
    1790812799999,
    1557658297.323858,
    3218097
  ],
  [
    1790812800000,
    83623.59,
    85273.65,
    83186.0,
    84880.05,
    16766.05675,
    1790899199999,
    1409485416.762407,
    3018436
  ],
  [
    1790899200000,
    84880.05,
    87220.0,
    83888.0,
    84518.01,
    26497.91954,
    1790985599999,
    2268231876.268694,
    3801781
  ]
]
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.