coingecko-api

name	coingecko-api
description	Call the CoinGecko API to fetch crypto prices, market data, coin metadata, or charts; use when a task requires querying CoinGecko endpoints, building a quick data pull, or automating CoinGecko API requests (free or Pro).

CoinGecko API

Overview

Use this skill to call CoinGecko API endpoints reliably and repeatedly. It provides a small, standard-library script for GET requests, plus lightweight notes on common endpoints and auth.

Quick Start

Run the bundled script with a relative endpoint path:

python3 scripts/coingecko_get.py simple/price --param ids=bitcoin --param vs_currencies=usd

Use a full URL if you already have one:

python3 scripts/coingecko_get.py "https://api.coingecko.com/api/v3/coins/bitcoin"

Common Tasks

Get a spot price:

python3 scripts/coingecko_get.py simple/price \
  --param ids=bitcoin,ethereum \
  --param vs_currencies=usd

List all coins:

python3 scripts/coingecko_get.py coins/list

Get coin detail:

python3 scripts/coingecko_get.py coins/bitcoin

Get a market chart:

python3 scripts/coingecko_get.py coins/bitcoin/market_chart \
  --param vs_currency=usd \
  --param days=30

Auth And Base URL

If your plan requires an API key, pass it explicitly or set env vars:

• COINGECKO_API_KEY for the value
• COINGECKO_API_KEY_HEADER for the header name

Override the base URL as needed:

• Flag: --base-url https://...
• Env: COINGECKO_BASE_URL

Example:

COINGECKO_BASE_URL="https://api.coingecko.com/api/v3" \
COINGECKO_API_KEY="..." \
COINGECKO_API_KEY_HEADER="x-cg-pro-api-key" \
python3 scripts/coingecko_get.py coins/bitcoin

Output And Files

• --pretty pretty-prints JSON
• --raw bypasses JSON parsing
• --out path.json writes to a file

Example:

python3 scripts/coingecko_get.py coins/markets \
  --param vs_currency=usd \
  --param per_page=5 \
  --pretty \
  --out /tmp/markets.json

Reliability Tips

• Use --retries and --backoff for 429/5xx responses.
• Increase --timeout for large responses.
• Cache results if you poll frequently.

References

Read references/coingecko_api.md for base URL and endpoint patterns. Always verify in official CoinGecko docs if an endpoint or header fails.