Newhedge API Reference
Access real-time and historical data from any of the 2192 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).
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)
[
[
1780358400000,
58.09
],
[
1780444800000,
57.26
],
[
1780531200000,
57.94
]
]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.