Crypto Treasury Holdings Historical Chart Data by ID

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>'

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

GET

public_treasury

{entity_id}

{coin_id}

holding_chart

Crypto Treasury Holdings Historical Chart Data by ID

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>'

{
  "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.

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`

SDK Examples

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

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

response = client.public_treasury.get_holding_chart(
  "bitcoin",
  entity_id="strategy",
  days="365",
)

print(response.model_dump_json(indent=2))

Authorizations

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

Crypto Treasury Holdings by Entity ID Crypto Treasury Transaction History by Entity ID

CoinGecko API

Onchain API

Crypto Treasury Holdings Historical Chart Data by ID

Notes

SDK Examples

Authorizations

Path Parameters

Query Parameters

Response

​Notes

​SDK Examples

Authorizations

Path Parameters

Query Parameters

Response

Notes

SDK Examples