Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.coingecko.com/llms.txt

Use this file to discover all available pages before exploring further.

CoinGecko CLI is currently in Beta. We’re constantly improving, and your feedback is crucial.
Please share your feedback via this form, or submit a PR.
The CoinGecko CLI is a fast, full-featured terminal interface designed for developers, data analysts, and AI Agents who prefer the command line over a browser. It bridges the gap between raw API access and local data workflows with interactive dashboards and machine-readable outputs.

​
Get Started

1

Get API Key

Sign up for Demo (Free) or Pro (Paid) API key here, and retrieve the API Key in Developer Dashboard.
2

Install CoinGecko CLI

Visit the official CoinGecko CLI GitHub for full installation guides. It takes just 1-click, and less than a minute to complete the setup.
3

Use Commands

Refer here for full list of commands and features.

​
Features at a Glance

Interactive TUI

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

Data Pipelines

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

Live Price Streaming

Stream real-time market data and stay ahead of the curve.

AI Agent-Friendly

Easily test and integrate with AI/LLM tools via CLI.
FeatureWhat it does
🎮 Interactive TUI DashboardHigh-fidelity terminal interface with live navigation and 7-day price charts.
⚡ Real-Time PricesBlazingly fast, type-safe API calls for the most current market valuations.
📡 Live WebSocket StreamingReal-time price updates via cg watch with NDJSON output for piping.
📅 Deep Historical DataFetch precise data for specific dates, custom date ranges, or the past N days.
📥 CSV Export SupportExport any market or history query directly to CSV for external analysis in Excel or Python.
🏷️ Category SmartFilter by 500+ categories including AI, Layer-2, Tokenized Stocks, Gold, and Silver.
📊 Unlimited MarketsSeamless pagination to fetch 1,000+ coins in a single command.
🔥 Trending EverythingReal-time tracking of Trending Coins, NFTs, and Categories.
⌨️ JSON OutputMachine-readable -o json for scripting and pipelines.
🤖 Agent/LLM Friendly--dry-run mode and cg commands for tool integration.



​
Common Use Cases

The CoinGecko CLI is designed to be versatile, supporting both high-speed developer workflows and complex reasoning tasks for AI agents.
  • CI/CD Alerts: Integrate the CLI into GitHub Actions or local cron jobs to monitor price thresholds using -o json and tools like jq.
  • Rapid Dataset Generation: Fetch and export large market datasets (e.g. top 1000 coins) to CSV in seconds, bypassing the need for custom scripts.
  • Debugging & Tool Testing: Use --dry-run to visualize the exact API parameters and URL being constructed before implementing them in production code.
  • Shell Integration: Embed the CLI into your terminal prompt to see live metrics every time you open a session or run a command.
  • Function Calling: Give your LLM the cg binary as a tool to resolve coin symbols via cg search and perform technical analysis on results
  • Automated Market Research: Agents can identify “hot” sectors using cg trending and then drill down into specific performers using the --category filter.
  • Context Injection: Provide your agent with fresh, machine-readable data via -o json to ensure reasoning is based on real-time market conditions rather than static training data.
  • Agent Discovery: Use the cg commands utility to let an agent “self-document” its capabilities by reading the available sub-commands and metadata.
  • Historical Snapshots: Quickly generate historical CSV reports for specific dates or ranges to feed into Excel or Python dataframes.
  • Movers Analysis: Track the biggest gainers and losers across different timeframes and pool sizes for deeper sentiment analysis.
  • Category Benchmarking: Export raw data for specific sectors like “Layer-2” or “RWA” to compare performance metrics across an entire category.

​
Demo vs. Pro API Key

Demo Key (Free)Pro Key (Paid)
Rate Limit30 calls/minute>250 calls/minute
Refer Pricing page for full details
Monthly Credit10,000 calls>100,000 calls
Refer Pricing page for full details
Historical DataPast 1 yearBasic plan: past 2 years
Analyst plan & above: past 10+ years
FeaturesTUI
CSV Export
Price, Markets, Category, Trending



More features coming soon!		TUI
CSV Export
Price, Markets, Category, Trending
WebSocket Streaming (🔒 Analyst plan & above)
Top Gainers & Losers (🔒 Analyst plan & above)

More features coming soon!