bitcointreasuries.net APIbitcointreasuries.net ↗
Track Bitcoin holdings for public companies, governments, ETFs, and private firms. Real-time BTC price, mNAV, market cap, and news via 11 endpoints.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/05bbeee6-9b08-4dcd-8db7-34fd2695d1c0/get_btc_price' \ -H 'X-API-Key: $PARSE_API_KEY'
Retrieve the current BTC/USD price along with the last close price and date.
No input parameters required.
{
"type": "object",
"fields": {
"price": "current BTC price in USD (integer)",
"lastUpdated": "ISO timestamp of when the price was last updated",
"btcCloseDate": "date of the last close price (ISO date string)",
"btcClosePrice": "last daily close price in USD (integer)"
},
"sample": {
"data": {
"price": 80517,
"lastUpdated": "2026-05-15T12:37:22.498Z",
"btcCloseDate": "2026-05-14",
"btcClosePrice": 80517
},
"status": "success"
}
}About the bitcointreasuries.net API
The Bitcoin Treasuries API covers 11 endpoints that expose Bitcoin holdings, financial metrics, and news across six entity categories — public companies, private companies, governments, ETFs/funds, exchanges, and DeFi protocols. get_all_entities returns the full tracked universe with per-entity btc_balance, ticker, country, and market data, while get_public_companies adds deeper metrics like mNav, volatility, and stockPrice for every listed company holding BTC.
Entity Coverage and Holdings Data
The API tracks Bitcoin treasury entities across six categories: PUBLIC_COMPANY, PRIVATE_COMPANY, GOVERNMENT, FUND, EXCHANGE, and DEFI. get_all_entities returns the full list — including id, name, slug, type, btc_balance, country, and ticker — with no filtering required on the caller's side. Narrower endpoints like get_etf_treasuries, get_government_treasuries, and get_private_companies return the same entity shape scoped to a single category, making it straightforward to build category-specific dashboards without client-side filtering.
Financial Metrics for Public Companies
get_public_companies is the most data-dense endpoint. Each company object includes btcHoldings, marketCap, mNav (market-cap-to-net-asset-value ratio), stockPrice, return figures, volatility, and risk scores. get_playground_summary aggregates these across all tracked public companies into a single object: total_btc_held, total_market_cap_usd, avg_mnav (market-cap-weighted), total_volume_24h_usd, and companies_count. For ranked views, get_top100_public_companies returns up to 100 companies sorted by btc_balance descending.
Entity Detail and News
get_entity_detail accepts a slug parameter (obtainable from get_all_entities) and returns both structured overview data and editorial page_contents — including short_description, sections, and featured_stories for that entity. get_news_list returns the latest treasury-related articles with title, link, description, pubDate, category, imageUrl, and source fields, covering news relevant to the broader Bitcoin treasury ecosystem.
Pricing and Aggregate Stats
get_btc_price provides the current BTC/USD price, a lastUpdated timestamp, and the prior day's btcCloseDate and btcClosePrice. get_home_summary_stats combines per-category BTC totals (btc_tot) and entity counts with a live btc_price and total_btc_tracked, giving a single-call snapshot of the entire tracked universe.
- Monitor total BTC held by governments using
get_government_treasuriesand alert on balance changes. - Build a public-company BTC treasury screener using
mNav,volatility, andmarketCapfromget_public_companies. - Display a live leaderboard of the top 100 corporate BTC holders with
get_top100_public_companies. - Show ETF and fund BTC exposure alongside spot price using
get_etf_treasuriesandget_btc_price. - Power a treasury news feed filtered by category using
get_news_listarticle objects. - Build a summary dashboard combining
get_home_summary_statsandget_playground_summaryfor cross-category totals. - Render individual company profile pages using
page_contentsfields fromget_entity_detail.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does bitcointreasuries.net have an official developer API?+
What does `get_public_companies` return that `get_all_entities` does not?+
get_all_entities returns a baseline entity record with btc_balance, ticker, country, and basic market data. get_public_companies adds deeper financial metrics specific to listed equities: mNav, stockPrice, volatility, return figures, debt metrics, and a risk score — fields that are only meaningful for publicly traded companies.Is historical BTC holdings data available across entities?+
get_btc_price, but does not expose a time-series of holdings per entity. You can fork the API on Parse and revise it to add a historical holdings endpoint if the source data supports it.Can I filter `get_news_list` results by entity or category?+
get_news_list endpoint returns all available articles at once, each with a category field in the response. Filtering by category or entity must be done client-side. The endpoint does not currently accept filter parameters. You can fork the API on Parse and revise it to add server-side filtering by category or source.How fresh is the BTC price returned by `get_btc_price`?+
lastUpdated ISO timestamp indicating when the price was last refreshed. The btcClosePrice and btcCloseDate fields reflect the prior day's closing price, not an intraday value. For real-time trading precision, treat these figures as indicative rather than tick-level.