Skip to main content
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": [
    [
      1733097600000,
      402100
    ],
    [
      1733616000000,
      423650
    ]
  ],
  "holding_value_in_usd": [
    [
      1733097600000,
      39129037461.438065
    ],
    [
      1733616000000,
      42272572276.103065
    ]
  ]
}

​
Tips

  • You may obtain the entity ID and coin ID (API IDs) via several ways:
    • For entity_id:
      • refers to respective public treasury entity page and find ‘API ID’.
      • refers to /entities/list endpoint.
    • For coin_id:
      • refers to respective coin page and find ‘API ID’.
      • refers to /coins/list endpoint.
      • refers to google sheets here.

​
Note

  • Data available from August 2020 onwards.
  • Different API plans can access up to different historical periods via days param:
    PlanMaximum perioddays value availability
    Public/Demo1 year7, 14, 30, 90, 180, 365
    Basic2 years7, 14, 30, 90, 180, 365, 730
    Analyst and aboveFull7, 14, 30, 90, 180, 365, 730, max
  • For include_empty_intervals param:
    • When false (default): Only intervals with transaction data are returned.
    • When true: All requested intervals are returned, populated with the most recent available transaction data.
  • CoinGecko equivalent page: https://www.coingecko.com/en/treasuries/companies/strategy
  • Cache / Update Frequency: every 5 minutes for all the API plans.

Authorizations

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

Path Parameters

​
entity_id
string
default:strategy
required

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

Example:

"strategy"

​
coin_id
string
default:bitcoin
required

coin ID. example: bitcoin, ethereum, solana, binancecoin

Example:

"bitcoin"

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
default:false

include empty intervals with no transaction data, default: false

Response

200 - application/json

Get public companies & governments crypto treasury holding historical chart data

​
holdings
number[][]
​
holding_value_in_usd
number[][]