Discovery and markets API

Which public companies or governments hold this coin, and how much?

All public companies or governments holding a coin in their treasury, largest first: amount, value, cost and share of supply, with totals.

GET/api/external/discovery/treasury-holders

Get a free API key Try it in the API reference

What it returns

Every public company (or government) known to hold a coin in its treasury, largest holder first: the amount, its value now, what it cost and its share of the coin's supply, with the totals. The coin is a coin id (bitcoin, ethereum, solana). Undisclosed costs are null, never 0 — most governments and many companies do not disclose one. Each holder's name is the subject of treasury-entity for its holdings and trades. A coin no treasury is known to hold returns 404.

Chains

This endpoint is not tied to a chain: it takes no chain in its request.

Request

Send your key in the x-dex-data-key header. Replace each <placeholder> with a real value.

curl -H "x-dex-data-key: $DEXDATA_API_KEY" \
  "https://api.dexdata.io/api/external/discovery/treasury-holders"

Parameters
Parameter	Description
`coin` query · string · optional	The coin, by coin id, e.g. `bitcoin`, `ethereum`, `solana`. Defaults to bitcoin.
`holders` query · string · optional	Public `companies` or `governments`. Defaults to companies.`companiesgovernments`

Response fields

A JSON response. Every field is always present; null means the value could not be established, never zero.

Response fields of Which public companies or governments hold this coin, and how much?
Field	Type	Description
`coin`	string	The coin answered, by coin id, lowercase.
`holders`	string	The holders answered.
`totalAmount`	number \| null	Coins held by all of them together.
`totalValueUsd`	number \| null	What all of it is worth now, in USD.
`percentOfSupply`	number \| null	Their combined share of the coin's total supply, in percent (6.17 = 6.17%).
`entities`	object[]	Each holder, largest first. Can be empty.
`entities[].name`	string	The company's or government's name; it works as the subject of `treasury-entity`.
`entities[].symbol`	string \| null	Stock ticker with its exchange suffix, e.g. `MSTR.US`. Null for a government.
`entities[].country`	string \| null	Two-letter country code, e.g. `US`.
`entities[].amount`	number	Coins held. Always above 0: former holders are left out.
`entities[].valueUsd`	number \| null	What the holding is worth now, in USD.
`entities[].costBasisUsd`	number \| null	What the holding cost in total, in USD. Null when the cost is not disclosed.
`entities[].percentOfSupply`	number \| null	Share of the coin's total supply held, in percent (4.029 = 4.029%).

Price per call

Every call: 104 credits

Charged only when the call succeeds. Prices as of 2026-10-30; the current ones are always in the API reference.

What crypto does this public company or government hold, and what did it pay?
One holder's full treasury and its buys and sells, by the name listed here.
Which known on-chain entities belong to this category?
The other directory of named holders: the public companies and governments holding a coin.
How much of this coin do exchanges hold, and is it rising or falling?
Who else holds the coin in size — public companies and governments rather than exchanges.
Is each liquid-staking ETH token trading at, above or below its redemption rate?
Every liquid-staking ETH token: the ETH its contract redeems it for, the ETH the market pays, the gap in percent and the protocol fee. No chain, no input.
What is this tokenized stock, ETF or commodity worth, and where does it trade?
One tokenized real-world asset by id, ticker or name: its tokens with market caps, and every venue quoting them with price, 24 h volume and spread.
How has this tokenized stock, ETF or commodity moved over time?
One tokenized real-world asset's price, market cap and 24 h volume over 1 to 365 days, oldest first, in USD. The window sets the spacing.

Start building with DexData today

Sign in, create a key and make your first call in a minute. Free credits every month, and you only pay for calls that succeed.

Get a free API key