How do I install the Coingecko skill?

Run npx skillmds add majiayu000/coingecko-2 in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

What does the Coingecko skill do?

Query CoinGecko API for prices, market data, trending tokens, and historical charts. It is listed under Integrations & APIs on SkillMD.

Is Coingecko safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: makes network calls, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Coingecko?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Coingecko free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Coingecko?

majiayu000 (@majiayu000) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Coingecko by majiayu000 — Agent Skill

Name: Coingecko
Rating: 4.2 (5 reviews)
Author: majiayu000

File contents

CoinGecko API

Query cryptocurrency prices, market caps, charts, and trending tokens via the CoinGecko free API.

Base URL

https://api.coingecko.com/api/v3

No API key required. Rate limit: ~30 calls/minute.

Endpoints

Price Lookup

GET /simple/price?ids={ids}&vs_currencies={currencies}&include_24hr_change=true&include_market_cap=true

ids: comma-separated CoinGecko IDs (see ID table below)
vs_currencies: usd, btc, eth, bnb

Example: /simple/price?ids=bitcoin,ethereum&vs_currencies=usd&include_24hr_change=true

Token Price by Contract Address

GET /simple/token_price/{platform}?contract_addresses={addresses}&vs_currencies=usd&include_24hr_change=true

Platform IDs:

binance-smart-chain — BSC
ethereum — Ethereum
polygon-pos — Polygon
arbitrum-one — Arbitrum
optimistic-ethereum — Optimism
base — Base

Example: /simple/token_price/binance-smart-chain?contract_addresses=0x0E09FaBB73Bd3Ade0a17ECC321fD13a19e81cE82&vs_currencies=usd

Market Rankings

GET /coins/markets?vs_currency=usd&order=market_cap_desc&per_page=20&page=1&sparkline=false

Returns top coins with price, market cap, volume, and 24h change.

Historical Chart

GET /coins/{id}/market_chart?vs_currency=usd&days={days}

days: 1, 7, 14, 30, 90, 365, max
Returns arrays of [timestamp, value] for prices, market_caps, total_volumes

Coin Detail

GET /coins/{id}?localization=false&tickers=false&community_data=false&developer_data=false

Returns full metadata: description, links, contract addresses, market data.

CoinGecko ID Reference

Token	CoinGecko ID
BTC	bitcoin
ETH	ethereum
BNB	binancecoin
SOL	solana
USDT	tether
USDC	usd-coin
XRP	ripple
ADA	cardano
DOGE	dogecoin
AVAX	avalanche-2
DOT	polkadot
MATIC	matic-network
LINK	chainlink
UNI	uniswap
CAKE	pancakeswap-token
ARB	arbitrum
OP	optimism
AAVE	aave
LDO	lido-dao
SHIB	shiba-inu

For unknown tokens, search: GET /search?query={name}

Usage Notes

Always use curl -s to fetch, then parse the JSON response
For on-chain token prices not listed on CoinGecko, fall back to DEX quotes via swap_get_quote
The market-data skill provides high-level workflow guidance; this skill is the concrete API reference
Report data source and freshness: "CoinGecko, fetched just now"

---name: coingecko-2description: Query CoinGecko API for prices, market data, trending tokens, and historical charts.--- # CoinGecko API Query cryptocurrency prices, market caps, charts, and trending tokens via the CoinGecko free API. ## Base URL ``` https://api.coingecko.com/api/v3 ``` No API key required. Rate limit: ~30 calls/minute. ## Endpoints ### Price Lookup ``` GET /simple/price?ids={ids}&vs_currencies={currencies}&include_24hr_change=true&include_market_cap=true ``` - `ids`: comma-separated CoinGecko IDs (see ID table below) - `vs_currencies`: `usd`, `btc`, `eth`, `bnb` Example: `/simple/price?ids=bitcoin,ethereum&vs_currencies=usd&include_24hr_change=true` ### Token Price by Contract Address ``` GET /simple/token_price/{platform}?contract_addresses={addresses}&vs_currencies=usd&include_24hr_change=true ``` Platform IDs: - `binance-smart-chain` — BSC - `ethereum` — Ethereum - `polygon-pos` — Polygon - `arbitrum-one` — Arbitrum - `optimistic-ethereum` — Optimism - `base` — Base Example: `/simple/token_price/binance-smart-chain?contract_addresses=0x0E09FaBB73Bd3Ade0a17ECC321fD13a19e81cE82&vs_currencies=usd` ### Market Rankings ``` GET /coins/markets?vs_currency=usd&order=market_cap_desc&per_page=20&page=1&sparkline=false ``` Returns top coins with price, market cap, volume, and 24h change. ### Trending ``` GET /search/trending ``` Returns trending coins, NFTs, and categories. No parameters needed. ### Historical Chart ``` GET /coins/{id}/market_chart?vs_currency=usd&days={days} ``` - `days`: `1`, `7`, `14`, `30`, `90`, `365`, `max` - Returns arrays of `[timestamp, value]` for prices, market_caps, total_volumes ### Coin Detail ``` GET /coins/{id}?localization=false&tickers=false&community_data=false&developer_data=false ``` Returns full metadata: description, links, contract addresses, market data. ## CoinGecko ID Reference | Token | CoinGecko ID | | ----- | ----------------- | | BTC | bitcoin | | ETH | ethereum | | BNB | binancecoin | | SOL | solana | | USDT | tether | | USDC | usd-coin | | XRP | ripple | | ADA | cardano | | DOGE | dogecoin | | AVAX | avalanche-2 | | DOT | polkadot | | MATIC | matic-network | | LINK | chainlink | | UNI | uniswap | | CAKE | pancakeswap-token | | ARB | arbitrum | | OP | optimism | | AAVE | aave | | LDO | lido-dao | | SHIB | shiba-inu | For unknown tokens, search: `GET /search?query={name}` ## Usage Notes - Always use `curl -s` to fetch, then parse the JSON response - For on-chain token prices not listed on CoinGecko, fall back to DEX quotes via `swap_get_quote` - The `market-data` skill provides high-level workflow guidance; this skill is the concrete API reference - Report data source and freshness: "CoinGecko, fetched just now"

Frequently asked questions