CoinGecko CLI

A high-performance terminal interface for real-time and historical crypto data

A fast, full-featured terminal interface for developers, analysts, and AI agents. Interactive dashboards, CSV exports, WebSocket streaming, and machine-readable JSON output — all from the command line.

GitHub → | Commands Reference →

Interactive TUI

Full-screen terminal dashboard with live navigation and 7-day braille price charts.

CSV & JSON Export

Export market rankings and historical data directly to CSV or JSON for pipelines and analysis.

Live WebSocket Streaming

Real-time price updates via cg watch with NDJSON output for piping.

AI Agent-Friendly

--dry-run mode and cg commands for tool discovery and LLM integration.

Get Started

1. Install

   Homebrew

   brew install coingecko/coingecko-cli/cg
   

   Or download a binary from GitHub Releases.

2. Authenticate

   Get a Demo (free) or Pro (paid) API key, then run:

   cg auth
   

   Or pass credentials directly:

   Demo (Free)

   cg auth --key YOUR_API_KEY --tier demo
   

   Verify with cg status.

3. Try it out

   cg price --ids bitcoin,ethereum
   cg markets --total 100
   cg history bitcoin --days 7
   cg tui markets
   

   See the full Commands Reference for all available commands.

Use Cases

Developers — monitoring and tooling

• CI/CD alerts — integrate into GitHub Actions or cron jobs, monitor price thresholds with -o json and jq
• Dataset generation — fetch and export top 1000 coins to CSV in seconds
• Debugging — use --dry-run to preview exact API parameters and URLs before production code
• Shell integration — embed in your terminal prompt for live metrics

AI Agents — data retrieval and reasoning

• Function calling — give your LLM the cg binary as a tool, resolve symbols via cg search, and analyze results
• Market research — identify hot sectors with cg trending, drill into performers with --category
• Context injection — feed fresh -o json data to ensure reasoning uses real-time market conditions
• Self-documentation — cg commands lets agents discover available sub-commands

Analysts — data pipelines

• Historical snapshots — generate CSV reports for specific dates or ranges for Excel or Python
• Movers analysis — track biggest gainers/losers across timeframes
• Category benchmarking — export sector data (Layer-2, RWA, etc.) for cross-category comparison

---

Share Feedback

Tell us how you’re using the CLI and what we should improve.

Open an Issue or PR

Report bugs, request features, or contribute on GitHub.