Block.one

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/block-one/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.

1 metrics
Metric

Treasury Metrics

Bitcoin treasury summary metrics for the company.

Endpoint 
https://newhedge.io/api/v2/companies/block-one/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": 0.781,
  "share_price_change_state": ""
}
Not available for this company
  • bitcoin-acquisitions (Bitcoin Acquisitions) returns 404 {"error":"Data unavailable for this company"}
  • bitcoin-holdings (Bitcoin Holdings) returns 404 {"error":"Data unavailable for this company"}
  • bitcoin-holdings-usd (Bitcoin Holdings USD) returns 404 {"error":"Data unavailable 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"}