Request format
curl -X GET "https://newhedge.io/api/v2/metrics/yearly-candles/METRIC_NAME?api_token=YOUR_TOKEN"api_token (required) — 24 character token.
resolution (optional) — 1d only for the metrics on this chart. Any other value is refused with a 400 that names what is available; see Resolutions.
before (optional) — exclusive cursor, returns observations older than this timestamp_ms. Works on every resolution.
limit (optional) — the most recent N observations, maximum 5000. Finer resolutions page by default (2500); a 1d request returns the whole series unless you send limit or before.
before and limit narrow a time series. A response with no single time axis, such as a hash keyed by venue or a labelled snapshot table, has nothing to cut on. It is returned whole, and both parameters are ignored rather than rejected.
A before that is not a positive epoch-millisecond timestamp is a 400. It is the one paging value we reject rather than ignore, because a page size has a sensible default and a cursor does not.
include (optional) — definition wraps the response as {"definition": …, "data": …} and returns the record shown under each metric; see Definitions. Any other value is a 400.
:metric_name — one of the metric names listed below.
200 with JSON payload, 400 for an unknown include value, 401 for missing/invalid token, 404 for missing resources.
Metrics
Each metric is fetched independently. Responses are trimmed samples to show structure.
Yearly candlesyearly_candles
Data used by the Bitcoin Yearly Candles chart.
Resolutions: 1d only.
https://newhedge.io/api/v2/metrics/yearly-candles/yearly_candles?api_token=YOUR_TOKENReplace `YOUR_TOKEN` with your API token.
[
[
1704067200000,
43996.25,
106150.0,
39551.91,
92623.87
],
[
1735689600000,
93361.05,
124771.07,
76225.5,
87491.28
],
[
1790899200000,
88740.05,
96934.01,
58545.95,
84496.6
]
]Value: Bitcoin Yearly Candles: Annual price movements of Bitcoin over time.
Units: usd