---
title: "Crypto Treasury Holdings by Coin ID"
method: GET
path: "/{entity}/public_treasury/{coin_id}"
---

# Crypto Treasury Holdings by Coin ID

`GET /{entity}/public_treasury/{coin_id}`

To query public companies' and governments' cryptocurrency holdings by coin ID

## Path parameters

- `entity` 'companies' | 'governments', required
- `coin_id` string, required

## Query parameters

- `per_page` integer
- `page` integer
- `order` 'total_holdings_usd_desc' | 'total_holdings_usd_asc'

## Response `200`

Public companies or governments crypto treasury holdings data

- union
  - object
    - `total_holdings` number, required — Total crypto holdings
    - `total_value_usd` number, required — Total crypto holdings value in USD
    - `market_cap_dominance` number, required — Market cap dominance percentage
    - `companies` object[], required — List of companies holding crypto
      - `name` string, required — Company name
      - `symbol` string, nullable, required — Company ticker symbol
      - `country` string, required — Country code
      - `total_holdings` number, required — Total crypto holdings
      - `total_entry_value_usd` number, required — Total entry value in USD
      - `total_current_value_usd` number, required — Total current value of crypto holdings in USD
      - `percentage_of_total_supply` number, required — Percentage of total crypto supply
  - object
    - `total_holdings` number, required — Total crypto holdings
    - `total_value_usd` number, required — Total crypto holdings value in USD
    - `market_cap_dominance` number, required — Market cap dominance percentage
    - `governments` object[], required — List of governments holding crypto
      - `name` string, required — Government name
      - `symbol` string, nullable, required — Government ticker symbol
      - `country` string, required — Country code
      - `total_holdings` number, required — Total crypto holdings
      - `total_entry_value_usd` number, required — Total entry value in USD
      - `total_current_value_usd` number, required — Total current value of crypto holdings in USD
      - `percentage_of_total_supply` number, required — Percentage of total crypto supply

## Changes

- **2026-05-28** `006c13c1a566` — 1 breaking, 1 info
  - added `subschema #1: CompanyTreasury, subschema #2: GovernmentTreasury` to the response body `oneOf` list for the response status `200`
  - removed `subschema #1, subschema #2` from the response body `oneOf` list for the response status `200`
- **2026-05-28** `11cc9e00fd86` — 4 breaking, 2 info
  - for the `query` request parameter `order`, default value `total_holdings_usd_desc` was removed
  - for the `query` request parameter `page`, default value `1` was removed
  - for the `query` request parameter `per_page`, default value `250` was removed
  - added `subschema #1, subschema #2` to the response body `oneOf` list for the response status `200`
  - …2 more
- **2026-04-30** `fb6b6a203ce6` — 8 breaking
  - the response property `oneOf[#/components/schemas/CompaniesTreasury]/companies` became optional for the status `200`
  - the response property `oneOf[#/components/schemas/CompaniesTreasury]/market_cap_dominance` became optional for the status `200`
  - the response property `oneOf[#/components/schemas/CompaniesTreasury]/total_holdings` became optional for the status `200`
  - the response property `oneOf[#/components/schemas/CompaniesTreasury]/total_value_usd` became optional for the status `200`
  - …4 more
- …earlier changes not shown

[Full history](https://skmtc.dev/coingecko/apis/coingecko-api/changes/:entity/public_treasury/:coin_id/get.md)

---

[API](https://skmtc.dev/coingecko/apis/coingecko-api.md) · [All operations](https://skmtc.dev/coingecko/apis/coingecko-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/coingecko/coingecko-api/revisions/006c13c1a566/schema)