CoinGecko markets
Tool ID: coingecko_markets
Summary
Reads a market snapshot: current price, market cap, trading volume, all-time high and low, and recent percent changes. You can ask by coin id, ticker, name, or category, or ask for the top coins.
When to use it
- You want more than a spot price: cap, volume, and how much the price moved.
- You have a ticker such as btc and want the matching coin, including its id.
- You want the largest coins, or the largest coins in a category, one page at a time.
What you need
| Requirement | Required? |
|---|---|
| Metraclick connection | Yes |
| Tool enabled for your account | Yes |
| CoinGecko credential | Yes. Keys are optional. A Demo API key raises the rate limit; a Pro API key uses CoinGecko Pro. See the overview. |
Parameters
| Parameter | Required? | Description |
|---|---|---|
vs_currency |
No | Currency for prices. Leave it out for US dollars. |
ids |
No | Coin ids, such as bitcoin,ethereum. |
symbols |
No | Tickers, such as btc,eth. A ticker can match more than one coin. |
names |
No | Coin names, such as Bitcoin. |
category |
No | A category id, such as decentralized-finance-defi. |
order |
No | How to sort. Leave it out for CoinGecko’s default. |
per_page |
No | How many rows, from 1 to 50. Leave it out for 25. |
page |
No | Which page, starting at 1. |
sparkline |
No | Set this to include a 7-day sparkline. Leave it out to keep the answer short. |
price_change_percentage |
No | Extra change windows such as 1h or 7d. The 24-hour change is included either way. |
What you get back
The coins that matched, each with its id, ticker, and name, plus price, market cap, volume, highs and lows, and percent changes. The ids are repeated so a later question can reuse them.
Example prompts
How are bitcoin and ethereum doing in US dollars? Include market cap and the 24-hour change.
Show the top 10 coins by market cap.
What is the market snapshot for the ticker btc?
Tips
- When a ticker matches several coins, use the id of the one you meant for History.
- A page is at most 50 coins. Ask for the next page when you need more.