Pro API · v1
API documentation
Base URL https://investorsbitcoin.com. Authenticate with your key from /pro via Authorization: Bearer <key> (or ?api_key=). JSON in, JSON out; errors are { "error": "…" } with conventional status codes (401, 403, 404, 429, 503). Rate limits are per key and per minute by tier. All JSON responses include source and license fields — the data is informational only.
curl -s -H "Authorization: Bearer $IB_KEY" \ https://investorsbitcoin.com/api/v1/metrics | jq '.aggregates'
GET/api/v1/companies
Every tracked company, full record: holdings with as-of dates, cost basis, shares, market cap, category, risk notes, per-figure source URLs, and the complete debt schedule.
GET/api/v1/companies/{ticker}
One company by ticker (or slug). 404 for unknown tickers.
GET/api/v1/debt
The instrument-level convertible/debt table across all issuers — amounts, coupons, maturities, retired flags — plus outstanding totals. This table exists nowhere else as data.
GET/api/v1/metrics
Computed metrics at the live BTC price: basic mNAV (variant always labeled), sats per share, NAV, unrealized gain, plus sector aggregates.
GET/api/v1/history
List of available daily snapshot dates.
GET/api/v1/history/{YYYY-MM-DD}
The full dataset exactly as published on that date — point-in-time truth for backtests and audits.
GET/api/v1/changelog
Every change we make to the dataset, dated and sourced. Trackers usually edit silently; we keep the receipts.
GET/api/v1/pro.csv
Instrument-level debt table as CSV.
/api/dataset and /data.csv (headline data, CC BY 4.0). Pro data is licensed for subscriber use per the terms; public redistribution should use the CC BY dataset.