Coverage
What you get
| Item | Detail |
|---|---|
| Product code | CR-TREASURIES |
| Coverage | Listed companies and governments holding BTC or ETH |
| Granularity | One row per entity, per asset, per as-of date |
| History | Each holding change since the entity's first disclosed purchase |
| Delivery | REST |
| Update speed | When a new filing or announcement is published; current_value_usd daily |
Corporate holdings change in steps, usually when a company files an 8-K or a quarterly report. Government holdings come from official statements, court records and on-chain tracking of known addresses, and they're less certain. Every row keeps a source_filing so you can check where the number came from instead of trusting a dashboard.
Schema
Schema
| Field | Type | Required | Description |
|---|---|---|---|
entity_name |
string | yes | Company or government name |
entity_type |
string | yes | company or government |
ticker |
string | optional | Stock symbol for listed companies |
figi |
string | optional | FIGI |
country |
string | yes | ISO country code |
asset |
string | yes | e.g. BTC |
date |
string | yes | As-of date, YYYY-MM-DD |
holdings |
number | yes | Coins held |
average_entry_price_usd |
number | optional | Average cost per coin |
total_entry_value_usd |
number | optional | Total cost |
current_value_usd |
number | yes | Holdings times price |
unrealized_pnl_usd |
number | optional | Current minus entry value |
mnav |
number | optional | Market cap / net asset value of holdings |
source_filing |
string | optional | Filing or announcement the number comes from |
Example record:
{
"entity_name": "Example Holdings Corp",
"entity_type": "company",
"ticker": "EXHC",
"figi": null,
"country": "US",
"asset": "BTC",
"date": "2026-11-18",
"holdings": 12450,
"average_entry_price_usd": 61230.0,
"total_entry_value_usd": 762313500.0,
"current_value_usd": 966274380.0,
"unrealized_pnl_usd": 203960880.0,
"mnav": 1.38,
"source_filing": "8-K filed 2026-11-17"
}
The company and every figure are invented for the example. Still, the arithmetic holds: 12,450 coins at $61,230 is $762,313,500 of cost.
Sample data
Sample data
There's no free sample of this table yet. The free US company financials sample, taken from SEC EDGAR filings, shows the kind of source data it will be built from. Request a sample of treasury holdings and we'll send one when the first version is assembled.
Use cases
Use cases
mNAV trades. When mnav is well above 1, investors are paying more for the stock than the coins it holds are worth. Some traders track that premium over time and look for it to compress, or pair the stock against BTC.
Buying pressure from treasuries. Sum the change in holdings across all company rows per week. Large corporate purchases are disclosed after they happen, but the total shows how much demand came from balance sheets.
Stock as a bitcoin proxy. For a company whose current_value_usd is most of its market cap, the stock behaves like leveraged or discounted BTC. Regress its daily returns on BTC returns to measure the beta.
Cost basis stress. Compare average_entry_price_usd with the current price to see which holders would be under water after a drawdown, and by how much unrealized_pnl_usd would swing.
Code
Code examples
Example: all disclosed company BTC holdings with curl.
curl "https://api.marketdata.co/v1/crypto/treasuries?asset=BTC&entity_type=company" \
-H "Authorization: Bearer $MARKETDATA_API_KEY"
Example: Python, largest holders and their mNAV.
import os
import requests
import pandas as pd
resp = requests.get(
"https://api.marketdata.co/v1/crypto/treasuries",
params={"asset": "BTC", "entity_type": "company"},
headers={"Authorization": f"Bearer {os.environ['MARKETDATA_API_KEY']}"},
)
resp.raise_for_status()
t = pd.DataFrame(resp.json()["results"])
latest = t.sort_values("date").groupby("entity_name").tail(1)
cols = ["entity_name", "ticker", "holdings", "average_entry_price_usd", "mnav", "source_filing"]
print(latest.nlargest(10, "holdings")[cols])
Pricing
Pricing
| Plan | Crypto treasuries |
|---|---|
| Starter, $29/mo | Company and government holdings, history and mNAV |
It sits next to stock fundamentals and isn't sold as a separate dataset. Prices are early access and may change.
One vendor we studied gives a basic version away free. Another charges $49 to $584 a month for plans that include treasury metrics.
Side by side
How we compare
Only 2 of the 50 providers we studied sell crypto treasury data. We plan to build ours from the SEC filings we already parse for fundamentals, so each holding ties to a filing you can open. Company tickers join straight to our stock prices and fundamentals, which makes mNAV and beta work a one-line merge.
FAQ
Frequently asked questions
How often are holdings updated?
When a company or government discloses a change. current_value_usd and mnav recalculate daily from prices.
Where do government numbers come from?
Official statements, court and seizure records, and on-chain tracking of addresses linked to a government. These are less certain than company filings, and source_filing shows which kind applies.
What time zone does the date use?
date is the as-of date of the holding, in UTC. For filings, it's the date the holding was reported as of, not the filing date.
Are holdings adjusted for stock splits?
Coin counts don't change with stock splits. mnav uses market cap, which a split doesn't change either.
Is this real-time?
No. Holdings change only when disclosed, and filings can lag the actual purchase by days.
What format does it come in?
JSON from the REST API, one row per entity, asset and date.
Keep reading
Related
- Asset hub: Crypto
- Crypto: BTC-USD, ETH-USD, SOL-USD, XRP-USD, BNB-USD, DOGE-USD
- Docs: API reference: fundamentals
- Learn: Choosing a market data provider