Cryptoclaw coingecko

Query CoinGecko API for prices, market data, trending tokens, and historical charts.

install

source · Clone the upstream repo

git clone https://github.com/TermiX-official/cryptoclaw

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/TermiX-official/cryptoclaw "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/coingecko" ~/.claude/skills/termix-official-cryptoclaw-coingecko && rm -rf "$T"

manifest: skills/coingecko/SKILL.md

source content

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"