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

[CoinGecko SKILL](https://github.com/coingecko/skills) is an installable package that gives AI agents built-in knowledge of the CoinGecko API, including endpoints, parameters, and common workflows.

* Instead of manually explaining the API to your agent every time, the **SKILL lets your agent understand CoinGecko data instantly** and respond with accurate queries and code.

* The SKILL works with popular AI coding agents and tools such as Claude Code, Gemini CLI, Codex CLI, and other SKILL-compatible agents. **Setup takes less than 3 minutes**.

You can check out the repo at [github.com/coingecko/skills](https://github.com/coingecko/skills), or follow the installation instructions below.

***

## Installation

You may install the CoinGecko SKILL package using one of the following methods, depending on your preferences:

* For **Coding agents**, we recommend following [this section](#setting-up-for-agents-/-llms).
* For **Claude web users**, please follow [this section](#setting-up-for-claude-ai) instead.

***

### Setting up for Agents / LLMs

*\*such as Claude Code, Gemini CLI, Codex CLI*

#### Installation via [skills.sh](https://skills.sh/)

<Steps>
  <Step title="Install the `skills` package globally to manage SKILLs across your system">
    ```bash theme={null}
    npm install -g skills
    ```

    *\*see [npmjs/skills](https://www.npmjs.com/package/skills) for more details.*
  </Step>

  <Step title="Install the CoinGecko SKILL package using `npx skills`">
    ```bash theme={null}
    npx skills add coingecko/skills -g -y
    ```

    *\*`-g` flag to install globally for all agents.*
  </Step>
</Steps>

#### Installation via GitHub

*\*see [github.com/coingecko/skills](https://github.com/coingecko/skills)*

<Steps>
  <Step title="Clone from the GitHub repository">
    ```bash theme={null}
    git clone https://github.com/coingecko/skills.git coingecko-skills
    ```
  </Step>

  <Step title="Move the cloned artifact to your agent's SKILLs directory">
    ```bash theme={null}
    mv coingecko-skills ~/.claude/skills/coingecko
    ```

    *\*the exact path may vary based on your agent and operating system. <br />\*example above is for Claude Code on Mac/Linux.*
  </Step>
</Steps>

***

### Setting up for [Claude.ai](https://claude.ai/)

<Steps>
  <Step title="Download the SKILL package (.zip) from GitHub">
    Visit [https://github.com/coingecko/skills/archive/refs/heads/main.zip](https://github.com/coingecko/skills/archive/refs/heads/main.zip)
  </Step>

  <Step title="Upload the `skills-main.zip` to claude.ai">
    1. Visit [https://claude.ai/customize/skills](https://claude.ai/customize/skills)
    2. Select '+' -> 'Upload a skill'

    <Frame>
      <img src="https://mintcdn.com/coingecko/phsN_J1K7MuyOqmI/images/docs/Screenshot2026-03-14at22.06.52.png?fit=max&auto=format&n=phsN_J1K7MuyOqmI&q=85&s=4f09083374b29a7c047302cb7b45c4be" style={{ width:"600px",height:"auto" }} width="3024" height="1614" data-path="images/docs/Screenshot2026-03-14at22.06.52.png" />
    </Frame>

    3. Upload the `skills-main.zip` file you downloaded from GitHub.

    <Frame>
      <img src="https://mintcdn.com/coingecko/phsN_J1K7MuyOqmI/images/docs/Screenshot2026-03-14at22.10.41.png?fit=max&auto=format&n=phsN_J1K7MuyOqmI&q=85&s=a27a12a3c4932bb57307f18e0806bee4" style={{ width:"600px",height:"auto" }} width="3024" height="1614" data-path="images/docs/Screenshot2026-03-14at22.10.41.png" />
    </Frame>

    4. You are all set!

    <Frame>
      <img src="https://mintcdn.com/coingecko/phsN_J1K7MuyOqmI/images/docs/Screenshot2026-03-14at22.12.35.png?fit=max&auto=format&n=phsN_J1K7MuyOqmI&q=85&s=24cb39c344f1bf362b270e7c26b29bc9" style={{ width:"600px",height:"auto" }} width="3024" height="1614" data-path="images/docs/Screenshot2026-03-14at22.12.35.png" />
    </Frame>
  </Step>
</Steps>

### Constraints for Claude.ai 🚧

The SKILL already includes built-in workarounds for Claude.ai platform restrictions, so most users won't run into issues.<br />
However, **if your API calls are failing silently or returning network errors**, check the following:

#### Allowlist CoinGecko domains (Claude paid plans only)

Claude blocks outbound requests to domains not on your personal allowlist. To fix this:

<Frame>
  <img src="https://mintcdn.com/coingecko/na3hXlxdlDjqAJC9/images/docs/claude-user-allowlist.png?fit=max&auto=format&n=na3hXlxdlDjqAJC9&q=85&s=3d03f117a54604c9d97d92db0e5ba59b" style={{ width:"600px",height:"auto" }} width="1916" height="932" data-path="images/docs/claude-user-allowlist.png" />
</Frame>

1. Go to [https://claude.ai/settings/capabilities](https://claude.ai/settings/capabilities), then scroll down to the "Domain allowlist" section.

2. Under "Additional allowed domains", add both:
   * `pro-api.coingecko.com`
   * `api.coingecko.com`

#### Artifacts cannot make API calls directly

* Claude Artifacts run in a sandboxed environment that blocks all external API calls — including CoinGecko.

* The SKILL handles this automatically by instructing Claude to fetch data server-side first, then pass the results into the Artifact as static data.

<br />

<Tip>
  ### Use it with the CoinGecko MCP Server

  We recommend setting up the CoinGecko MCP Server together with the SKILL for the best experience, especially if you're on the **Claude free plan**.

  All under 5 minutes by following the instructions in our [MCP guides](/docs/mcp-server).
</Tip>

***

## What's next?

Once installed, try asking your agent / LLM questions like:

> *"If I invested \$100 in Bitcoin back in December 2018, how much would it be worth today?"*

> *"What was the ATH of XPL?"*

> *"What is the current market cap of DZnQi17HFgSM8mJ4nhVicz32B97XyTsd6MUVuDJgP9Jo from Solana?"*

> *"What if I only left \$50 in my wallet? Which coins should I buy to maximize my returns based on the current market?"*

> *"What are the top NFT collections this week?"*

> *... have fun experimenting!*

***

<Card title="Share your feedback" icon="link" href="https://forms.gle/oiZ86EwNxeTxCVEL7" arrow="true" cta="Take the survey">
  Tell us how you're using the CoinGecko SKILL and what we should improve!
</Card>

Have feedback or need help? Reach out to `eason.lim@coingecko[dot]com`.