iShares Bitcoin Trust

Company API endpoints for Bitcoin treasury, holdings, price, profile, and performance data.

How to call

Request format

GET

curl -X GET "https://newhedge.io/api/v2/companies/ishares-bitcoin-trust/METRIC_NAME?api_token=YOUR_TOKEN"

Query params

api_token (required) — 24 character token.

Path params

:metric_name — one of the company metric names listed below.

Responses

200 with JSON payload, 401 for missing/invalid token, 404 for missing resources. A company removed from the dataset answers 404, with a successor field when its Bitcoin treasury is now tracked under another company, for example {"error":"Company not found","successor":"strive-asset-management"}. A renamed company keeps answering at its old slug.

Plan and quota refusals keep these statuses and error texts and add code, required_plan, current_plan, feature, upgrade_url, limit and resets_at where they apply. A Pro token whose history window removed points also gets the X-Newhedge-History-Truncated headers, and for a Pro token X-Newhedge-Available-From is the start of the window. See Errors and plan limits.

Currency, security and adjustment

`price-data` is daily OHLCV in the LOCAL currency of the listing. Prices are not converted to US dollars, and a listing quoted in GBX is in pence.
Prices are adjusted for splits. They are not adjusted for dividends.
The `company-data` snapshot names the security and exchange: `exchange`, `currency` and `isin`.
Metaplanet is served through its US over-the-counter listing, in USD. Smarter Web is served through its US over-the-counter listing, in USD.

Holdings

Acquisitions are replaced from the provider on each run.
Daily `bitcoin-holdings` are forward-filled and restate over 45 days.
`bitcoin-holdings-usd` is holdings times the daily Bitcoin price and restates with the holdings.

Acquisition fields

holding_net_change: Provider field. Bitcoin bought (positive) or sold (negative).
holding_balance: Provider field. Bitcoin held after the transaction.
source_url: Provider field. Public source of the disclosure.
transaction_value_usd: The provider value, or the absolute bitcoin amount times the daily Bitcoin price when the provider value is implausible. `transaction_value_calculated` is true when we calculated it.
transaction_value_calculated: True when transaction_value_usd was calculated.
average_entry_value_usd: The provider value. A non-zero value outside 0.5 to 2.0 times the day's Bitcoin price is set to null. A zero is kept as 0 and means the provider did not report a price.

Metrics

Each company metric is fetched independently.

7 metrics

Metric

Bitcoin Acquisitions

Bitcoin acquisition history for the company.

Endpoint

https://newhedge.io/api/v2/companies/ishares-bitcoin-trust/bitcoin-acquisitions?api_token=YOUR_TOKEN

Replace `YOUR_TOKEN` with your Newhedge API token.

Sample response

200 Successful response

[
  {
    "date": 1792627200000,
    "type": "sell",
    "coin_id": "bitcoin",
    "holding_net_change": -3023.572441868518
  },
  {
    "date": 1792713600000,
    "type": "sell",
    "coin_id": "bitcoin",
    "holding_net_change": -1357.899621056136
  },
  {
    "date": 1792972800000,
    "type": "buy",
    "coin_id": "bitcoin",
    "holding_net_change": 1377.712582425434
  }
]

Metric

Bitcoin Holdings

Historical Bitcoin holdings for the company.

Endpoint

https://newhedge.io/api/v2/companies/ishares-bitcoin-trust/bitcoin-holdings?api_token=YOUR_TOKEN

Replace `YOUR_TOKEN` with your Newhedge API token.

Sample response

200 Successful response

[
  [
    1792886400000,
    811138.25348355
  ],
  [
    1792972800000,
    810079.8556605401
  ],
  [
    1793059200000,
    811160.81350714
  ]
]

Metric

Bitcoin Holdings USD

Historical USD value of the company's Bitcoin holdings.

Endpoint

https://newhedge.io/api/v2/companies/ishares-bitcoin-trust/bitcoin-holdings-usd?api_token=YOUR_TOKEN

Replace `YOUR_TOKEN` with your Newhedge API token.

Sample response

200 Successful response

[
  [
    1792886400000,
    65494806703.51688
  ],
  [
    1792972800000,
    64855187663.3482
  ],
  [
    1793059200000,
    64889888120.38564
  ]
]

Metric

Price Data

Historical market price data stored on the company profile.

Endpoint

https://newhedge.io/api/v2/companies/ishares-bitcoin-trust/price-data?api_token=YOUR_TOKEN

Replace `YOUR_TOKEN` with your Newhedge API token.

Sample response

200 Successful response

[
  {
    "low": 44.86,
    "date": "2026-10-26",
    "high": 45.688,
    "open": 45.155,
    "close": 45.22,
    "volume": 30414000
  },
  {
    "low": 45.12,
    "date": "2026-10-27",
    "high": 45.71,
    "open": 45.27,
    "close": 45.7,
    "volume": 26079300
  },
  {
    "low": 45.43,
    "date": "2026-10-28",
    "high": 46.14,
    "open": 45.575,
    "close": 46.14,
    "volume": 20332140
  }
]

Metric

Company Data

Company profile, fundamentals, and related reference data.

Endpoint

https://newhedge.io/api/v2/companies/ishares-bitcoin-trust/company-data?api_token=YOUR_TOKEN

Replace `YOUR_TOKEN` with your Newhedge API token.

Sample response

200 Successful response

{
  "eps_estimate_next_quarter": null,
  "quarterly_earnings_growth": null,
  "eps_estimate_current_quarter": null
}

Metric

Performance Metrics

Calculated performance metrics for the company.

Endpoint

https://newhedge.io/api/v2/companies/ishares-bitcoin-trust/performance-metrics?api_token=YOUR_TOKEN

Replace `YOUR_TOKEN` with your Newhedge API token.

Sample response

200 Successful response

{
  "one_month_return": -2.51,
  "six_month_return": 7.93,
  "three_month_return": 25.72
}

Metric

Treasury Metrics

Bitcoin treasury summary metrics for the company.

Endpoint

https://newhedge.io/api/v2/companies/ishares-bitcoin-trust/treasury-metrics?api_token=YOUR_TOKEN

Replace `YOUR_TOKEN` with your Newhedge API token.

Sample response

200 Successful response

{
  "btc_percent_company": "-",
  "total_btc_percentage": 3.863,
  "share_price_change_state": ""
}