Bitcoin Treasuries 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.
What is the Bitcoin Treasuries 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.
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'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace bitcointreasuries-net-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""
Bitcoin Treasuries API - Usage Example
Get your API key from: https://parse.bot/settings
"""
from parse_apis.bitcoin_treasuries_api import BitcoinTreasuries, Entity, PublicCompany, Article, Fund, Government
bt = BitcoinTreasuries()
# Get current BTC price
price = bt.btcprices.get()
print(price.price, price.btcCloseDate)
# List all entities and inspect the top ones
for entity in bt.entities.list(limit=5):
print(entity.name, entity.slug, entity.btc_balance)
# Get detail for a specific entity
strategy = bt.entities.get(slug="strategy")
print(strategy.name, strategy.btc_balance, strategy.type)
# List public companies with financial metrics
for company in bt.publiccompanies.list(limit=3):
print(company.name, company.symbol, company.btcHoldings, company.mNav)
# List ETF/fund holdings
for fund in bt.funds.list(limit=3):
print(fund.name, fund.btc_balance, fund.ticker)
# List government holdings
for gov in bt.governments.list(limit=3):
print(gov.name, gov.btc_balance, gov.country.name)
# Get aggregate playground summary
summary = bt.playgroundsummaries.get()
print(summary.btc_price, summary.total_btc_held, summary.companies_count)
# Get latest news
for article in bt.articles.list(limit=3):
print(article.title, article.pubDate, article.source)
Retrieve the current BTC/USD price along with the last daily close price and close date. Updates frequently throughout the day.
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": 61787,
"lastUpdated": "2026-06-11T00:18:59.805Z",
"btcCloseDate": "2026-06-10",
"btcClosePrice": 61787
},
"status": "success"
}
}About the Bitcoin Treasuries API
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.
The Bitcoin Treasuries API is a managed, monitored endpoint for bitcointreasuries.net — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when bitcointreasuries.net changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official bitcointreasuries.net API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- 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 | 100 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.