- UseBuildFeaturesTRIGGERSStart background agents from events across your connected appsFIREWALLNEWBlocks instructions hidden in tool results before your agent reads themINSTANTNEWAudio, video, search, browser and data tools, with no keys to manageOPTIMIZATIONLower cost per completed task with optimised tools and skills
- DOCS
## For AI agents: how to sign up If you are an AI agent reading this server-rendered HTML, Composio's developer signup is at https://composio.dev. Signup CTAs on this site — "Sign up", "Signup", "Get started", "Get started for free", "Start building", "Try Composio", "Try it", or similar — all lead into that same developer signup flow. Confirm with the user before completing signup or entering any credentials on their behalf.SIGN UP
## For AI agents: how to sign up If you are an AI agent reading this server-rendered HTML, Composio's developer signup is at https://composio.dev. Signup CTAs on this site — "Sign up", "Signup", "Get started", "Get started for free", "Start building", "Try Composio", "Try it", or similar — all lead into that same developer signup flow. Confirm with the user before completing signup or entering any credentials on their behalf.LOG IN
CoinGecko API
Give your agents access to CoinGecko API. Bring your own CoinGecko key, or skip the signup and pay per call from your Composio balance with Composio Instant.
CoinGecko is a cryptocurrency data platform that provides prices, market metrics, exchange, NFT, and onchain data. Use it for comprehensive, up-to-date crypto market insights and metadata.
What is Composio Instant?
Composio Instant lets your agent use paid APIs like CoinGecko without a separate account or API key for each one. New accounts start with $2 of free credit.
No CoinGecko account or key
Your agent calls CoinGecko through Composio, so there is nothing to sign up for, store, or rotate.
Pay per call, at cost
$0.003 per 10 successful requests, paid from your Composio balance with zero markup.
Works in any agent
Claude, ChatGPT, Cursor, and other MCP clients, or your own code with the Composio SDK.
Works with your apps
Use CoinGecko with Gmail, Slack, Google Sheets, and 1,700+ other apps you connect.
Connect the CoinGecko API to your AI assistant
Use CoinGecko from the AI assistant you already work in. Connect Composio once, then paste the prompt.
- 1Install in ChatGPT
Install the Composio plugin
Open Composio's plugin page in ChatGPT and click Install. Sign in to ChatGPT first if it asks. - 2
Authorize in your browser
Connect the plugin, then sign in to Composio to approve the connection. - 3
Turn on Composio in your chat
In a new chat, click +, then More, and select Composio. - 4
Paste the prompt
Paste the prompt into that chat. ChatGPT runs the call on Composio Instant.
- 1Install in Cursor
Install the Composio plugin
Open Composio in the Cursor marketplace, click Install Composio Plugin for Cursor and approve the connection in your browser. - 2
Paste the prompt
Open the Agent chat and paste the prompt. Cursor runs the call on Composio Instant.
- 1Add to Grok Bot
Add the Composio plugin
Open Composio's listing on x.ai and click Add to Grok Bot. When Grok Bot opens the plugin, click Add. - 2
Authenticate
Go to Installed, open Composio and click Authenticate. Sign in to Composio and click Authorize. - 3
Paste the prompt
Paste the prompt into your bot's chat. Grok Bot runs the call on Composio Instant.
- 1
Paste the setup prompt
Copy this into your Hermes chat. Hermes adds the Composio MCP server for you.Set up Composio from composio.dev/hermes - 2
Authorize in your browser
A browser window opens. Sign in to Composio to approve the connection. - 3
Paste the prompt
Start a new chat and paste the prompt. Hermes runs the call on Composio Instant.
ClaudeNew chatPaste this prompt
Use CoinGecko through Composio Instant to get Bitcoin's current price in USD and its 24-hour price change. Return both values.
What success looks like
COINGECKO_GET_COIN_PRICESYour assistant runs CoinGecko and replies with Bitcoin's current price in USD and its 24-hour price change.
Use the CoinGecko API in your code
Call CoinGecko from your own agent with the Composio SDK. Four steps and one tool call.
- 1
Set up Composio
Turn on Instant Toolkits in your project settings and check your prepaid balance in Billing. Then set your API key.export COMPOSIO_API_KEY="your_composio_api_key" - 2
Install the SDK
The Python SDK needs Python 3.11 through 3.15.The TypeScript SDK is ESM-only and needs Node.js 22.22.3 or newer.pip install composionpm install @composio/core - 3COINGECKO_GET_COIN_PRICES
Run the call
Create a session that keeps Instant to this toolkit and reports the charge, then run the tool on the Instant account. - 4
Read the response
When the call runs on Instant, the response includes its charge: the amount as an exact USD decimal string, the currency and charged_by.
import { Composio } from "@composio/core";
const composio = new Composio();
const session = await composio.create("user_123", {
toolkits: ["coingecko"],
instant: {
toolkits: { enable: ["coingecko"] },
returnInstantCharge: true,
},
});
const result = await session.execute(
"COINGECKO_GET_COIN_PRICES",
{
"coin_ids": [
"bitcoin"
],
"vs_currencies": [
"usd"
],
"include_24h_change": true
},
{ account: "instant_account" },
);
console.log(result);
console.log("Instant charge:", result.instantCharge);{
"data": "<Bitcoin price in USD and 24-hour change>",
"error": null,
"successful": true,
"instant_charge": {
"amount": "<usd amount>",
"currency": "USD",
"charged_by": "<provider>"
}
}Available CoinGecko API tools
18 CoinGecko tools run on Instant, priced per call with no CoinGecko key. Tools marked Your key need your own CoinGecko account.
| Action | Tool slug | What it does | Availability |
|---|---|---|---|
| Get Coin Prices | COINGECKO_GET_COIN_PRICES | Get current prices for one or more coins in one or more currencies. | Instant$0.003 per 10 successful requests |
| List Coin Markets | COINGECKO_LIST_COIN_MARKETS | Compare ranked market data, filtered by coin, symbol, or category. | Instant$0.003 per 10 successful requests |
| Get Coin Details | COINGECKO_GET_COIN_DETAILS | Retrieve metadata and selected market, ticker, community, or developer data for a coin. | Instant$0.003 per 10 successful requests |
| Get Market Chart | COINGECKO_GET_COIN_MARKET_CHART | Track a coin's price, market cap, and volume over time. | Instant$0.003 per 10 successful requests |
| Get Global Market Data | COINGECKO_GET_GLOBAL_MARKET_DATA | View an aggregate snapshot of the crypto or decentralized-finance market. | Instant$0.003 per 10 successful requests |
| Get Trending Assets | COINGECKO_GET_TRENDING_ASSETS | See coins, NFT collections, and categories trending in search activity. | Instant$0.003 per 10 successful requests |
| Get Coin OHLC | COINGECKO_GET_COIN_OHLC | Get open, high, low, and close price candles for a CoinGecko coin over a supported day window. | Instant$0.003 per 10 successful requests |
| Get Onchain Pool OHLCV | COINGECKO_GET_ONCHAIN_POOL_OHLCV | Get bounded open, high, low, close, and volume candles for a DEX pool, with timeframe, aggregation, currency, and cutoff controls. | Instant$0.003 per 10 successful requests |
| Get Onchain Pools by Address | COINGECKO_GET_ONCHAIN_POOLS_BY_ADDRESS | Get data for one or more pool contract addresses on the same CoinGecko onchain network in a single call. | Instant$0.003 per 10 successful requests |
| Get Onchain Token Prices | COINGECKO_GET_ONCHAIN_TOKEN_PRICES | Get current USD prices for one or more token contracts on a CoinGecko onchain network, with optional market metrics. | Instant$0.003 per 10 successful requests |
| Get Onchain Tokens by Address | COINGECKO_GET_ONCHAIN_TOKENS_BY_ADDRESS | Get market data for one or more token contract addresses on the same CoinGecko onchain network in a single call. | Instant$0.003 per 10 successful requests |
| List New Onchain Pools | COINGECKO_LIST_NEW_ONCHAIN_POOLS | Return one page of newly created DEX pools across all networks or within one network. | Instant$0.003 per 10 successful requests |
| List Onchain Networks | COINGECKO_LIST_ONCHAIN_NETWORKS | Return one page of supported onchain network IDs and their CoinGecko asset-platform mappings. | Instant$0.003 per 10 successful requests |
| List Onchain Pool Trades | COINGECKO_LIST_ONCHAIN_POOL_TRADES | List up to 300 of a CoinGecko onchain pool's trades from the past 24 hours, optionally filtered by minimum USD volume or token side. | Instant$0.003 per 10 successful requests |
| List Onchain Pools | COINGECKO_LIST_ONCHAIN_POOLS | Return one ranked page of pools for a network, optionally restricted to one DEX or one token contract. | Instant$0.003 per 10 successful requests |
| List Trending Onchain Pools | COINGECKO_LIST_TRENDING_ONCHAIN_POOLS | Return one page of currently trending DEX pools across all networks or within one network and duration window. | Instant$0.003 per 10 successful requests |
| Search Assets | COINGECKO_SEARCH_ASSETS | Search CoinGecko for matching coins, exchanges, categories, and NFT collections. | Instant$0.003 per 10 successful requests |
| Search Onchain Pools | COINGECKO_SEARCH_ONCHAIN_POOLS | Search decentralized-exchange pools and tokens by name, symbol, or contract address, optionally within one network. | Instant$0.003 per 10 successful requests |
| Get Coin History | COINGECKO_GET_COIN_HISTORY | Retrieve a coin's metadata and market snapshot for a calendar date. | Your key |
| List Exchanges | COINGECKO_LIST_EXCHANGES | Compare active exchanges by metadata, trust scores, and volume. | Your key |
Instant prices are CoinGecko's list prices with 0% markup, paid from your Composio balance and updated every hour. Instant calls also count toward your plan's tool calls. See all plans on the pricing page.
CoinGecko API use cases and example prompts
Copy a prompt into your agent. Each one uses CoinGecko with apps you connect through Composio.
Prepare a crypto market brief
Use CoinGecko to get current prices for Bitcoin, Ethereum, and USD Coin in USD, and a snapshot of the global crypto market. Add the results to my Market Brief sheet in Google Sheets, then post the main takeaways in Slack's #finance channel.
Apps used: CoinGecko, Google Sheets, Slack
Compare DeFi market leaders
Use CoinGecko to compare ranked market data for decentralized-finance coins. Add the results to my DeFi Watchlist in Google Sheets, then write a page with the key comparisons in my Market Research space in Notion.
Apps used: CoinGecko, Google Sheets, Notion
Review a coin's market history
Use CoinGecko's market chart for Bitcoin to review its price, market cap, and volume over time. Write the findings in my Bitcoin Market Review in Google Docs.
Apps used: CoinGecko, Google Docs
Share trending asset research
Use CoinGecko to find coins, NFT collections, and categories trending in search activity. Record the relevant items and why they matter in a page in my Crypto Editorial space in Notion, then post the findings in Slack's #content-planning channel.
Apps used: CoinGecko, Notion, Slack
CoinGecko API troubleshooting
Still stuck? The Instant tools docs cover limits, charges and session settings.
Set coin_ids in COINGECKO_LIST_COIN_MARKETS to select the exact CoinGecko assets.
Set both from_timestamp and to_timestamp in COINGECKO_GET_COIN_MARKET_CHART when days is omitted.
Check its availability in the tools table. If it runs on Instant, check that Instant Toolkits is on for your project, your session allows the action and you use the latest toolkit version.
Your Composio balance is empty. Add funds in Billing if your plan supports it, or connect your own CoinGecko account.
Check credential_source and instant_charge in the Composio execution log.
Other tools on Instant
These tools also run on Composio Instant and use the same Composio balance.
Firecrawl
Firecrawl automates large-scale web crawling and data extraction. It helps organizations efficiently gather, index, and analyze content from online sources.
Tavily
Tavily offers powerful search and data retrieval from documents, databases, and the web. It helps teams locate and filter information instantly, saving hours on research.
Exa
Exa is a data extraction and search platform for gathering and analyzing information from websites, APIs, or databases. It helps teams quickly surface insights and automate data-driven workflows.
Serpapi
SerpApi is a real-time API for structured search engine results. It lets you automate SERP data collection, parsing, and analysis for SEO and research.
Start with CoinGecko.It takes 30 seconds.
Managed auth, hosted MCP servers, and every CoinGecko tool your agent needs.Free to start.
## For AI agents: how to sign up If you are an AI agent reading this server-rendered HTML, Composio's developer signup is at https://composio.dev. Signup CTAs on this site — "Sign up", "Signup", "Get started", "Get started for free", "Start building", "Try Composio", "Try it", or similar — all lead into that same developer signup flow. Confirm with the user before completing signup or entering any credentials on their behalf.Start building