public-market-data

Public companies holding a coin in treasury

Keyless list of public companies holding bitcoin, ethereum, solana or binancecoin (bnb is accepted as an alias), largest holding first, with the coin-wide totals. Data provided by CoinGecko: keep the source attribution next to any display of these values. The upstream list is read at most every 12 hours and never served older than 24 hours. status is fresh within 12 hours, stale up to 24 hours, and unavailable (null totals, no companies) when no usable copy exists; an upstream failure still answers 200. tradfiTicker links a US-listed company to its /api/market/references/{ticker} reference when one exists. Other coins return 404; any query parameter returns 400.

get/api/market/treasuries/{coin}

Request

  • Base URL: https://api.coinrithm.com
  • URL: https://api.coinrithm.com/api/market/treasuries/{coin}
  • Auth: none required

Path parameters

coinstring required

bitcoin, ethereum, solana, binancecoin or bnb (case-insensitive).

Response

Company holdings, totals, freshness and attribution

coinstring required

Canonical coin id (bitcoin, ethereum, solana, binancecoin).

status'fresh' | 'stale' | 'unavailable' required

Freshness of an upstream dataset CoinRithm re-reads on a schedule. stale data is still served inside its documented maximum age; unavailable means no usable copy, never zero or empty truth.

totalHoldingsnumber nullable required
totalValueUsdnumber nullable required
asOfstring date-time nullable required

When CoinRithm read the upstream list.

Changes

No recorded changes to this operation across all 1 revision of this API.