Newhedge API Reference
Access real-time and historical data from any of the 2314 metrics that power Newhedge dashboards, charts, and company treasury pages. Our RESTful API provides programmatic access to comprehensive Bitcoin and financial market data.
Overview
The Newhedge API enables developers to integrate our extensive dataset into their applications, dashboards, and analysis tools. All endpoints return JSON responses with time-series data that mirrors what you see on our platform.
Each chart and treasury company exposes one or more metrics that can be queried individually. Metrics return either arrays of [timestamp, value] pairs or keyed objects, depending on the data structure.
Quick Start
To get started, you'll need an API token from your account settings. Once you have your token, you can make requests to any endpoint using the base URL:
GET /api/v2/metrics/:chart_slug/:metric_name?api_token=YOUR_TOKEN
GET /api/v2/companies/:company_slug/:metric_name?api_token=YOUR_TOKEN
Browse the available charts and companies in the sidebar to find the metrics you need. Each page shows all available metrics, sample requests, and response formats.
For Cursor, Claude, ChatGPT Code Interpreter, and MCP clients, see AI agents & MCP (markdown).
Resolutions
Series are daily (day1) by default. Advanced and Enterprise accounts may request finer buckets, coarse to fine: hour12, hour4, hour1, 30mn, 10mn.
GET /api/v2/metrics/:chart_slug/:metric_name?resolution=hour1&api_token=YOUR_TOKEN
Only the metrics endpoint accepts resolution. The company, news, and price endpoints are daily-only.
A resolution request is never rejected. If the calling account is not entitled to finer data, if the metric does not ingest the bucket you asked for, or if the value is not recognised, the response is the day1 series with HTTP 200 — not a 400 or 404. Read X-Newhedge-Resolution for what was actually served instead of assuming you received what you asked for.
X-Newhedge-Available-Resolutions lists, coarse to fine, exactly what the calling token may request for that metric, and any value it lists is served verbatim — so read it rather than probing each bucket. It is per-metric, not per-chart: two metrics on the same chart can offer different sets, because a metric only offers a bucket it actually ingests.
Finer pagination
Finer responses are paged newest-first. day1 responses ignore both parameters and are returned in full.
Page size. Default 2500, maximum 5000.
Exclusive timestamp_ms cursor — returns observations strictly older than it.
Page backwards by sending the previous response's X-Newhedge-Next-Before as before, or by following the Link header. The Link URL omits api_token — re-attach your own token before requesting it.
Finer series are sparse. A bucket with no observation is absent rather than forward-filled, so consecutive points are not always evenly spaced.
Response headers
Timestamps are epoch milliseconds.
X-Newhedge-Resolution — resolution actually served.
X-Newhedge-Available-Resolutions — resolutions this token may request for this metric.
X-Newhedge-Limit — page size used.
X-Newhedge-Has-More — true when older observations remain.
X-Newhedge-From / X-Newhedge-To — oldest / newest timestamp in this page.
X-Newhedge-Available-From / X-Newhedge-Available-To — oldest / newest timestamp in the whole finer series.
X-Newhedge-Next-Before — cursor for the next older page.
Link — RFC 8288 rel="next", without api_token.
What You Can Do
- Query real-time and historical Bitcoin metrics
- Access on-chain data, market indicators, and analytics
- Access Bitcoin treasury company holdings, acquisitions, and profile data
- Build custom dashboards and data visualizations
- Integrate Newhedge data into custom algorithms and research tools
- Monitor market trends and perform quantitative analysis
GET /api/v2/metrics/:chart_slug/:metric_name
GET /api/v2/companies/:company_slug/:metric_name
Authenticate
Send your 24-character API token via the `api_token` query param. Requests without it return 401.
Choose a dataset
Pick any chart or company from the sidebar. Each page exposes one or more metrics you can query individually.
Call the endpoint
Hit the chart or company metric or news endpoint to receive the JSON used on the site.
Curl
curl -X GET "https://newhedge.io/api/v2/metrics/bitcoin-dominance/btc_dominance?api_token=YOUR_TOKEN"Swap `YOUR_TOKEN` with the secret from your account. Replace the chart and metric to target other datasets.
Bitcoin Dominance (BTC.D)
[
[
1788825600000,
58.64
],
[
1788912000000,
58.52
],
[
1788998400000,
57.83
]
]Responses are either arrays of `[timestamp, value]` pairs or keyed hashes, depending on the metric.
API-ready datasets
These charts and companies expose metrics through the API. Select one on the left to view its metric list and sample responses.
On-Chain Analytics
Network activity, transaction volumes, address analytics, and blockchain health indicators.
Treasury Companies
Company profile, price, performance, treasury, holdings, and acquisition datasets.
Market Intelligence
Exchange volumes, trading pairs, liquidity metrics, and market dominance indicators.
Network Metrics
Network health, difficulty adjustments, hash rate, and network growth indicators.
Mining Analytics
Mining profitability, hash rate distribution, miner revenue, and pool dominance.
ETFs & Structured Products
Bitcoin ETF holdings, flows, premiums, discounts, and institutional product data.
Exchanges
Exchange trading volumes, liquidity metrics, exchange flows, and market share data.
Futures
Futures trading volumes, futures prices, and futures contracts.
Transactions
Transaction volumes, transaction fees, and transaction patterns.