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

> A high-performance terminal interface for real-time & historical crypto data, built in Go.

<Frame>
  <img src="https://mintcdn.com/coingecko/2wLa35TPQIr07ei5/images/Screenshot2026-03-06at11.32.40PM.png?fit=max&auto=format&n=2wLa35TPQIr07ei5&q=85&s=992d3bb122c95866a4bdc7018a458ee2" style={{ width:"600px",height:"auto" }} width="1138" height="874" data-path="images/Screenshot2026-03-06at11.32.40PM.png" />
</Frame>

<Warning>
  CoinGecko CLI is currently in Beta. We're constantly improving, and your feedback is crucial. \
  Please share your feedback via this [form](https://forms.gle/VgpVbwsSJLgE7D8Q7), or submit a [PR](https://github.com/coingecko/coingecko-cli/pulls).
</Warning>

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

<Steps>
  <Step title="Get API Key">
    Sign up for Demo (Free) or Pro (Paid) API key [here](https://www.coingecko.com/en/api/pricing), and retrieve the API Key in [Developer Dashboard](https://www.coingecko.com/en/developers/dashboard).
  </Step>

  <Step title="Install CoinGecko CLI">
    Visit the official [CoinGecko CLI GitHub](https://github.com/coingecko/coingecko-cli?tab=readme-ov-file#install) for full installation guides. It takes just 1-click, and less than a minute to complete the setup.
  </Step>

  <Step title="Use Commands">
    Refer [here](https://github.com/coingecko/coingecko-cli?tab=readme-ov-file#commands) for full list of commands and features.
  </Step>
</Steps>

***

## Features at a Glance

<CardGroup cols={2}>
  <Card icon="chart-line" title="Interactive TUI">
    Full-screen terminal dashboard with live navigation and 7-day braille price charts.
  </Card>

  <Card icon="file-csv" title="Data Pipelines">
    Export market rankings and historical data directly to CSV or JSON.
  </Card>
</CardGroup>

<CardGroup cols={2}>
  <Card icon="bolt-lightning" title="Live Price Streaming">
    Stream real-time market data and stay ahead of the curve.
  </Card>

  <Card icon="robot" title="AI Agent-Friendly">
    Easily test and integrate with AI/LLM tools via CLI.
  </Card>
</CardGroup>

| Feature                          | What it does                                                                                 |
| -------------------------------- | -------------------------------------------------------------------------------------------- |
| 🎮 **Interactive TUI Dashboard** | High-fidelity terminal interface with live navigation and 7-day price charts.                |
| ⚡ **Real-Time Prices**           | Blazingly fast, type-safe API calls for the most current market valuations.                  |
| 📡 **Live WebSocket Streaming**  | Real-time price updates via `cg watch` with NDJSON output for piping.                        |
| 📅 **Deep Historical Data**      | Fetch precise data for specific dates, custom date ranges, or the past N days.               |
| 📥 **CSV Export Support**        | Export any market or history query directly to CSV for external analysis in Excel or Python. |
| 🏷️ **Category Smart**           | Filter by 500+ categories including AI, Layer-2, Tokenized Stocks, Gold, and Silver.         |
| 📊 **Unlimited Markets**         | Seamless pagination to fetch 1,000+ coins in a single command.                               |
| 🔥 **Trending Everything**       | Real-time tracking of Trending Coins, NFTs, and Categories.                                  |
| ⌨️ **JSON Output**               | Machine-readable `-o json` for scripting and pipelines.                                      |
| 🤖 **Agent/LLM Friendly**        | `--dry-run` mode and `cg commands` for tool integration.                                     |

<br />

<Frame>
  <img src="https://mintcdn.com/coingecko/2wLa35TPQIr07ei5/images/Screenshot2026-03-06at11.27.04PM.png?fit=max&auto=format&n=2wLa35TPQIr07ei5&q=85&s=ece120ab311d044749b934e95319ccf3" style={{ width:"500px",height:"auto" }} width="1472" height="872" data-path="images/Screenshot2026-03-06at11.27.04PM.png" />
</Frame>

<br />

<Frame>
  <img src="https://mintcdn.com/coingecko/2wLa35TPQIr07ei5/images/Screenshot2026-03-06at11.28.44PM.png?fit=max&auto=format&n=2wLa35TPQIr07ei5&q=85&s=1bde63b518cb4fba6dc7d7759d2d1490" style={{ width:"500px",height:"auto" }} width="1442" height="1046" data-path="images/Screenshot2026-03-06at11.28.44PM.png" />
</Frame>

<br />

<Frame>
  <img src="https://mintcdn.com/coingecko/T0h960qynVPtBI8e/images/Screenshot2026-03-06at11.29.50PM.png?fit=max&auto=format&n=T0h960qynVPtBI8e&q=85&s=23187f8a5de84c21b648f772fc6a1576" style={{ width:"500px",height:"auto" }} width="1142" height="398" data-path="images/Screenshot2026-03-06at11.29.50PM.png" />
</Frame>

***

## Common Use Cases

The CoinGecko CLI is designed to be versatile, supporting both high-speed developer workflows and complex reasoning tasks for AI agents.

<AccordionGroup>
  <Accordion icon="code" title="Developers: Market Monitoring & Tooling">
    * **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.
  </Accordion>

  <Accordion icon="robot" title="AI Agents: Data Retrieval & Reasoning">
    * **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.
  </Accordion>

  <Accordion icon="file-spreadsheet" title="Analysts: Data Pipelines">
    * **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.
  </Accordion>
</AccordionGroup>

## Demo vs. Pro API Key

|                     | Demo Key (Free)                                                                                                 | Pro Key (Paid)                                                                                                                                                                                                     |
| ------------------- | --------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Rate Limit**      | 30 calls/minute                                                                                                 | >250 calls/minute <br />Refer [Pricing page](https://www.coingecko.com/en/api/pricing) for full details                                                                                                            |
| **Monthly Credit**  | 10,000 calls                                                                                                    | >100,000 calls <br />Refer [Pricing page](https://www.coingecko.com/en/api/pricing) for full details                                                                                                               |
| **Historical Data** | Past 1 year                                                                                                     | Basic plan: past 2 years <br />Analyst plan & above: past 10+ years                                                                                                                                                |
| **Features**        | TUI<br />CSV Export<br />Price, Markets, Category, Trending<br /><br /><br /><br />*More features coming soon!* | TUI<br />CSV Export<br />Price, Markets, Category, Trending<br />**WebSocket Streaming** (🔒 Analyst plan & above)<br />**Top Gainers & Losers** (🔒 Analyst plan & above)<br /><br />*More features coming soon!* |