United States

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

View in Newhedge External link

How to call

Request format

GET 
curl -X GET "https://newhedge.io/api/v2/companies/united-states/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.

4 metrics
Metric

Bitcoin Acquisitions

Bitcoin acquisition history for the company.

Endpoint 
https://newhedge.io/api/v2/companies/united-states/bitcoin-acquisitions?api_token=YOUR_TOKEN

Replace `YOUR_TOKEN` with your Newhedge API token.

Sample response
200 Successful response 
[
  {
    "date": 1753920000000,
    "type": "buy",
    "coin_id": "bitcoin",
    "source_url": null,
    "holding_balance": 198022.0,
    "holding_net_change": 10.0,
    "transaction_value_usd": 1157604.2,
    "average_entry_value_usd": 0.0,
    "transaction_value_calculated": true
  },
  {
    "date": 1760400000000,
    "type": "buy",
    "coin_id": "bitcoin",
    "source_url": "https://www.justice.gov/opa/pr/chairman-prince-group-indicted-operating-cambodian-forced-labor-scam-compounds-engaged",
    "holding_balance": 325293.0,
    "holding_net_change": 127271.0,
    "transaction_value_usd": 14392219583.46,
    "average_entry_value_usd": 0.0,
    "transaction_value_calculated": true
  },
  {
    "date": 1769644800000,
    "type": "buy",
    "coin_id": "bitcoin",
    "source_url": "https://www.justice.gov/opa/pr/government-forfeits-over-400m-assets-tied-helix-darknet-cryptocurrency-mixer",
    "holding_balance": 329693.0,
    "holding_net_change": 4400.0,
    "transaction_value_usd": 372070820.0,
    "average_entry_value_usd": 0.0,
    "transaction_value_calculated": true
  }
]
Metric

Bitcoin Holdings

Historical Bitcoin holdings for the company.

Endpoint 
https://newhedge.io/api/v2/companies/united-states/bitcoin-holdings?api_token=YOUR_TOKEN

Replace `YOUR_TOKEN` with your Newhedge API token.

Sample response
200 Successful response 
[
  [
    1793059200000,
    329693.0
  ],
  [
    1793145600000,
    329693.0
  ],
  [
    1793232000000,
    329693.0
  ]
]
Metric

Bitcoin Holdings USD

Historical USD value of the company's Bitcoin holdings.

Endpoint 
https://newhedge.io/api/v2/companies/united-states/bitcoin-holdings-usd?api_token=YOUR_TOKEN

Replace `YOUR_TOKEN` with your Newhedge API token.

Sample response
200 Successful response 
[
  [
    1793059200000,
    26374230026.69
  ],
  [
    1793145600000,
    26619449086.23
  ],
  [
    1793232000000,
    26796972282.08
  ]
]
Metric

Treasury Metrics

Bitcoin treasury summary metrics for the company.

Endpoint 
https://newhedge.io/api/v2/companies/united-states/treasury-metrics?api_token=YOUR_TOKEN

Replace `YOUR_TOKEN` with your Newhedge API token.

Sample response
200 Successful response 
{
  "btc_percent_company": 0.0,
  "total_btc_percentage": 1.57,
  "share_price_change_state": "up"
}
Not available for this company
  • price-data (Price Data) returns 404 {"error":"Data unavailable for this company"}
  • company-data (Company Data) returns 404 {"error":"Data unavailable for this company"}
  • performance-metrics (Performance Metrics) returns 404 {"error":"Data unavailable for this company"}