Crypto Treasury Holdings Historical Chart Data by ID

To query historical cryptocurrency holdings chart of public companies and governments by entity ID and coin ID

GET /public_treasury/{entity_id}/{coin_id}/holding_chart

Crypto Treasury Holdings Historical Chart Data by ID

cURL

curl --request GET \
  --url https://api.coingecko.com/api/v3/public_treasury/{entity_id}/{coin_id}/holding_chart \
  --header 'x-cg-demo-api-key: <api-key>'

200

{
  "holdings": [
    [
      1748736000000,
      580955
    ],
    [
      1749340800000,
      582000
    ]
  ],
  "holding_value_in_usd": [
    [
      1748736000000,
      60818730878.617355
    ],
    [
      1749340800000,
      61506606585.45032
    ]
  ]
}

Notes

• Find entity IDs via Entities List and coin IDs via Coins List.

• Data available from August 2020 onwards.

• Historical access varies by plan:

  Plan	Maximum period	days values
  Demo / Keyless API	1 year	7, 14, 30, 90, 180, 365
  Basic	2 years	7, 14, 30, 90, 180, 365, 730
  Analyst and above	Full	7, 14, 30, 90, 180, 365, 730, max

  To access longer historical periods, subscribe to a paid plan.

• include_empty_intervals=false (default): only intervals with transactions. Set to true to return all intervals, filled with the most recent data.

• Equivalent page on CoinGecko Strategy Treasury.

SDK Examples

TypeScript

const response = await client.publicTreasury.getHoldingChart('bitcoin', {
  entity_id: 'strategy',
  days: '365',
});

console.log(JSON.stringify(response, null, 2));

Authorizations

headerAuthqueryAuth

x-cg-demo-api-key · string · header · required

Learn how to set up your API key

Path Parameters

entity_id · string · default: strategy · required

Public company or government entity ID. *refers to /entities/list.

coin_id · string · default: bitcoin · required

Coin ID. e.g. bitcoin, ethereum, solana, binancecoin

Query Parameters

days · string · default: 365 · required

Data up to number of days ago. Valid values: 7, 14, 30, 90, 180, 365

include_empty_intervals · boolean

Include empty intervals with no transaction data. Default: false

Response

200 - application/json

Crypto treasury holdings historical chart data

holdings · number[][] · required

Historical holdings data as [timestamp, amount] pairs

holding_value_in_usd · number[][] · required

Historical holdings value in USD as [timestamp, value_usd] pairs