Bullish

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/bullish/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/bullish/bitcoin-acquisitions?api_token=YOUR_TOKEN

Replace `YOUR_TOKEN` with your Newhedge API token.

Sample response
200 Successful response
[
  {
    "date": 1767139200000,
    "type": "sell",
    "coin_id": "bitcoin",
    "source_url": "https://s206.q4cdn.com/295320002/files/doc_financials/2025/q4/Bullish-2025Q4-Shareholder-Update-2026_2_05-updated.pdf",
    "holding_balance": 23300.0,
    "holding_net_change": -1100.0,
    "transaction_value_usd": 96240408.0,
    "average_entry_value_usd": 0.0,
    "transaction_value_calculated": true
  },
  {
    "date": 1774915200000,
    "type": "buy",
    "coin_id": "bitcoin",
    "source_url": "https://investors.bullish.com/static-files/e91c6049-8105-449e-9ee3-af343ee7185e",
    "holding_balance": 23700.0,
    "holding_net_change": 400.0,
    "transaction_value_usd": 27266644.0,
    "average_entry_value_usd": 0.0,
    "transaction_value_calculated": true
  },
  {
    "date": 1782777600000,
    "type": "buy",
    "coin_id": "bitcoin",
    "source_url": "https://investors.bullish.com/static-files/265a2005-84a9-4e2a-9e9a-690ee43c19ab",
    "holding_balance": 23800.0,
    "holding_net_change": 100.0,
    "transaction_value_usd": 5854595.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/bullish/bitcoin-holdings?api_token=YOUR_TOKEN

Replace `YOUR_TOKEN` with your Newhedge API token.

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

Bitcoin Holdings USD

Historical USD value of the company's Bitcoin holdings.

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

Replace `YOUR_TOKEN` with your Newhedge API token.

Sample response
200 Successful response
[
  [
    1793059200000,
    1903912654.0
  ],
  [
    1793145600000,
    1921614618.0
  ],
  [
    1793232000000,
    1934429728.0
  ]
]
Metric

Price Data

Historical market price data stored on the company profile.

Endpoint
https://newhedge.io/api/v2/companies/bullish/price-data?api_token=YOUR_TOKEN

Replace `YOUR_TOKEN` with your Newhedge API token.

Sample response
200 Successful response
[
  {
    "low": 26.88,
    "date": "2026-10-26",
    "high": 28.27,
    "open": 28.27,
    "close": 27.6,
    "volume": 925893
  },
  {
    "low": 27.7,
    "date": "2026-10-27",
    "high": 29.43,
    "open": 28.15,
    "close": 28.94,
    "volume": 1176134
  },
  {
    "low": 27.78,
    "date": "2026-10-28",
    "high": 29.145,
    "open": 29.1,
    "close": 28.73,
    "volume": 776994
  }
]
Metric

Company Data

Company profile, fundamentals, and related reference data.

Endpoint
https://newhedge.io/api/v2/companies/bullish/company-data?api_token=YOUR_TOKEN

Replace `YOUR_TOKEN` with your Newhedge API token.

Sample response
200 Successful response
{
  "eps_estimate_next_quarter": 0.29,
  "quarterly_earnings_growth": 0,
  "eps_estimate_current_quarter": 0.0912
}
Metric

Performance Metrics

Calculated performance metrics for the company.

Endpoint
https://newhedge.io/api/v2/companies/bullish/performance-metrics?api_token=YOUR_TOKEN

Replace `YOUR_TOKEN` with your Newhedge API token.

Sample response
200 Successful response
{
  "one_month_return": -19.48,
  "six_month_return": -21.31,
  "three_month_return": 27.18
}
Metric

Treasury Metrics

Bitcoin treasury summary metrics for the company.

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

Replace `YOUR_TOKEN` with your Newhedge API token.

Sample response
200 Successful response
{
  "btc_percent_company": 44.4,
  "total_btc_percentage": 0.113,
  "share_price_change_state": "down"
}