# Coingecko API

> 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).

- Skill: `jiayaoqijia/coingecko-api` (Agent Skill, multi-file: 6 files)
- Install (CLI): `npx get-skill add jiayaoqijia/coingecko-api`
- Raw SKILL.md: https://api.skillmd.com/api/skills/jiayaoqijia/coingecko-api/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: jiayaoqijia (https://skillmd.com/u/jiayaoqijia)
- Updated: 2026-11-12
- Page: https://skillmd.com/skills/jiayaoqijia/coingecko-api

---


# 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:

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

Use a full URL if you already have one:

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

## Common Tasks

Get a spot price:

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

List all coins:

```bash
python3 scripts/coingecko_get.py coins/list
```

Get coin detail:

```bash
python3 scripts/coingecko_get.py coins/bitcoin
```

Get a market chart:

```bash
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:

```bash
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:

```bash
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.


