How to use the CoinGecko API Reference agent skill

What the coingecko skill makes the agent do

An agent skill is a set of instructions and reference files that an AI agent loads when a task matches it. This skill loads documentation from the CoinGecko API, so when you ask about CoinGecko endpoints or a crypto price tracker, the agent reads those documents instead of relying only on memory.

The skill contains documentation only. It does not connect to CoinGecko, so it returns no live market data.

• Explains CoinGecko endpoints and their parameters
• Covers authentication, including the Demo plan key and paid plan Pro-API key
• Documents market data, exchanges, NFTs, trending coins and pricing
• Helps structure code for a crypto price tracker

Install the coingecko skill from the ZIP or the Claude apps

Download the ZIP file for the skill from this directory page. Then choose one of the install routes below.

For Claude Code, unzip the folder into your personal skills directory ~/.claude/skills/, or into a project's .claude/skills/ folder if you want it limited to one project.

In the Claude apps, you can upload the skill instead under Settings → Capabilities → Skills.

• Personal install: unzip into ~/.claude/skills/
• Project install: unzip into the project's .claude/skills/ folder
• Claude apps: Settings → Capabilities → Skills, then upload the skill

Trigger the skill with natural requests

You do not need a special command. Ask in plain language about CoinGecko, and the agent should load the skill when the request matches its description. The skill's own description says it applies when you integrate the CoinGecko API, build crypto price trackers, or access cryptocurrency market data.

Name CoinGecko explicitly and mention the kind of information you need, such as an endpoint, a parameter or a data type. This makes it more likely the agent picks up the reference files.

• Which CoinGecko endpoint returns exchange volume history?
• Write a Python function that calls the CoinGecko Demo API for a coin's market cap.
• Explain how the CoinGecko exchange volume chart granularity works.
• What does the CoinGecko NFT contract address endpoint not support?

Example answers the reference files support

The reference files include details that are easy to get wrong from memory. For example, the exchange volume chart endpoint returns volume in BTC, and the docs point you to the exchange rates endpoint to convert it to other currencies.

Data granularity for that chart is automatic and cannot be changed: 1 day gives 10-minute data, 7 and 14 days give hourly data, and 30 days or more give daily data.

The NFT collection by contract address endpoint does not support Solana NFTs or Art Blocks, so the docs direct you to the NFT by ID endpoint for those.

Use the authentication details safely

The authentication reference distinguishes the Public Demo API from paid plans. Demo API keys work only with the Public Demo API, whose root URL is https://api.coingecko.com/api/v3/. Paid plan users with a Pro-API key should follow the main authentication page the docs link to.

The docs recommend storing your API key securely in your own backend and using a proxy to insert the key into requests, rather than exposing it in client-side code.

• Demo key: Public Demo API only, root URL https://api.coingecko.com/api/v3/
• Paid plans: Pro-API key, following the non-demo authentication page
• Keep keys in your backend, not in front-end code

Know what the skill does not do and its limits

The skill runs no scripts and uses no network connection, and it lists no required dependencies. It is documentation only.

The skill was generated automatically from official documentation, and its own notes say it is not curated. Its documents may be out of date, so check endpoints and current data against CoinGecko's official site before relying on them in production.

• No live prices or current market data
• No investment or trading guidance
• Verify endpoints against official CoinGecko docs before production use