BTCS S.A.

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/btcs-s-a/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/btcs-s-a/bitcoin-acquisitions?api_token=YOUR_TOKEN

Replace `YOUR_TOKEN` with your Newhedge API token.

Sample response
200 Successful response 
[
  {
    "date": 1765756800000,
    "type": "buy",
    "coin_id": "bitcoin",
    "source_url": "https://newconnect.pl/komunikat?geru_id=235605#pvy7zfso61",
    "holding_balance": 136.5347,
    "holding_net_change": 1.53,
    "transaction_value_usd": 137356.0,
    "average_entry_value_usd": 89500.23,
    "transaction_value_calculated": false
  },
  {
    "date": 1765756800000,
    "type": "buy",
    "coin_id": "bitcoin",
    "source_url": "https://newconnect.pl/komunikat?geru_id=235605#pvy7zfso61",
    "holding_balance": 136.6842,
    "holding_net_change": 0.15,
    "transaction_value_usd": 13382.0,
    "average_entry_value_usd": 89511.71,
    "transaction_value_calculated": false
  },
  {
    "date": 1767744000000,
    "type": "buy",
    "coin_id": "bitcoin",
    "source_url": "https://newconnect.pl/komunikat?geru_id=235998&title=Zamkni%C4%99cie+wcze%C5%9Bniejszej+pozycji+oraz+zawarcie+nowej+transakcji+na+instrumentach+pochodnych+na+Bitcoin+w+ramach+wsp%C3%B3%C5%82pracy+z+QCP+Trading+Pte.+Ltd.#pvy7zfso61",
    "holding_balance": 137.6719,
    "holding_net_change": 0.99,
    "transaction_value_usd": 90338.4801,
    "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/btcs-s-a/bitcoin-holdings?api_token=YOUR_TOKEN

Replace `YOUR_TOKEN` with your Newhedge API token.

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

Bitcoin Holdings USD

Historical USD value of the company's Bitcoin holdings.

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

Replace `YOUR_TOKEN` with your Newhedge API token.

Sample response
200 Successful response 
[
  [
    1793059200000,
    11013246.744127
  ],
  [
    1793145600000,
    11115644.349909
  ],
  [
    1793232000000,
    11189773.784464
  ]
]
Metric

Treasury Metrics

Bitcoin treasury summary metrics for the company.

Endpoint 
https://newhedge.io/api/v2/companies/btcs-s-a/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": 0.001,
  "share_price_change_state": "down"
}
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"}