CoinGecko history
Tool ID: coingecko_history
Summary
Reads how one coin’s price, market cap, and trading volume moved over a span of days. You need the coin id, such as bitcoin.
When to use it
- You want a trend, not only the latest price.
- You want daily points for a few months, or finer points for the last day or week.
What you need
| Requirement | Required? |
|---|---|
| Metraclick connection | Yes |
| Tool enabled for your account | Yes |
| CoinGecko credential | Yes. A blank credential or a Demo API key stops at 365 days. A Pro API key is required for the full history (max). |
Parameters
| Parameter | Required? | Description |
|---|---|---|
id |
Yes | Coin id, such as bitcoin. Use Search when you only have a name or ticker. |
vs_currency |
No | Currency for the prices. Leave it out for US dollars. |
days |
No | How far back: 1, 7, 14, 30, 90, 180, 365, or max. Leave it out for 7 days. |
interval |
No | Set this to daily when you want one point per day. Spans of 90 days or more already use daily points. |
What you get back
Three series for that coin: prices, market caps, and volumes. Each point is a time and a value.
Example prompts
Show bitcoin’s dollar price over the last 7 days.
Give me ethereum’s daily price and volume for the last 90 days.
How has solana’s market cap moved over the past year?
Tips
- A blank credential and a Demo API key both stop at 365 days. The full history (
max) needs a Pro API key. - A Demo API key raises the rate limit and still uses the public prices. See the key table on the CoinGecko overview.
- A long span uses daily points so the answer stays readable.