Skip to content

CoinGecko API and MCP

CoinGecko provides cryptocurrency prices, market capitalization, trading volume and token information. An agent can read cryptocurrency prices and market data for research reports. Add your CoinGecko key once in Longwave settings; calls run on your vendor account.

Add to Longwave

Add CoinGecko to your agent

Paste this into Claude Code or a terminal. Then run /mcp to sign in.

functions
97
access
Your key
tasks
4

Use CoinGecko on Longwave

  1. Download Longwave or open app.longwave.run.
  2. Add your CoinGecko API key once in Longwave settings. Calls run on your CoinGecko account at CoinGecko's price.
  3. Ask for the result in any thread, for example: “Read prices for a cryptocurrency watchlist”. The agent picks the CoinGecko function and calls it.

Use CoinGecko in Claude Code, Codex, Cursor or ChatGPT

Add the Longwave MCP server once. It carries 2,593 functions across 103 tools, including CoinGecko, and asks you to sign in on first use.

Why call CoinGecko through Longwave

  • Your CoinGecko key is stored once, encrypted, and used by every harness and device you use.
  • One MCP server for 103 tools, so your agent setup does not grow a key and a server per vendor.
  • Spending limits per key and per account, checked before a paid call is made.
  • Each call is recorded with the provider, the cost and the result, and can be read again from another device.

CoinGecko functions

Cryptocurrency 96

Every function here: Included in the applicable market-data subscription or free quota; entitlement and usage limits vary by endpoint. No standalone PAYG unit rate published. Included in the applicable market-data subscription or free quota; entitlement and usage limits vary by endpoint. No standalone PAYG unit rate published.

Function
List public treasury holders of a cryptocurrency Accepts an entity type, a coin ID and a sort order and returns public company and government holdings of a cryptocurrency. coingecko.openapi.get..entity.public_treasury.coin_id
List supported blockchain networks Accepts a network type and returns supported blockchain network names and identifiers. coingecko.openapi.get.asset_platforms
Get a cryptocurrency profile Accepts a coin ID, ticker symbols and developer data and returns coin metadata and market data. coingecko.openapi.get.coins.id
Get historical circulating cryptocurrency supply Accepts a coin ID, a history length in days and a bar interval and returns circulating coin supply over time. coingecko.openapi.get.coins.id.circulating_supply_chart
Get historical circulating cryptocurrency supply (date range) Accepts a coin ID, a start date and an end date and returns circulating coin supply over time. coingecko.openapi.get.coins.id.circulating_supply_chart.range
Get cryptocurrency data by token contract Accepts a coin ID and a token contract address and returns token metadata and market data. coingecko.openapi.get.coins.id.contract.contract_address
Get historical cryptocurrency markets by token contract Accepts a coin ID, a token contract address, a quote currency and a history length in days and returns token prices, market capitalization and trading volume over time. coingecko.openapi.get.coins.id.contract.contract_address.market_chart
Get historical cryptocurrency markets by token contract (date range) Accepts a coin ID, a token contract address, a quote currency and a start date and returns token prices, market capitalization and trading volume over time. coingecko.openapi.get.coins.id.contract.contract_address.market_chart.range
Get cryptocurrency market data for a date Accepts a coin ID and a date and returns coin price, market capitalization and trading volume on a date. coingecko.openapi.get.coins.id.history
Get historical cryptocurrency market data Accepts a coin ID, a quote currency, a history length in days and a bar interval and returns coin prices, market capitalization and trading volume over time. coingecko.openapi.get.coins.id.market_chart
Get historical cryptocurrency market data (date range) Accepts a coin ID, a quote currency, a start date and an end date and returns coin prices, market capitalization and trading volume over time. coingecko.openapi.get.coins.id.market_chart.range
Get cryptocurrency price bars Accepts a coin ID, a quote currency, a history length in days and a bar interval and returns coin open, high, low and close price bars. coingecko.openapi.get.coins.id.ohlc
Get cryptocurrency price bars (date range) Accepts a coin ID, a quote currency, a start date and an end date and returns coin open, high, low and close price bars. coingecko.openapi.get.coins.id.ohlc.range
Get a cryptocurrency supply breakdown Accepts a coin ID and returns coin supply amounts grouped by allocation. coingecko.openapi.get.coins.id.supply_breakdown
List trading pairs for a cryptocurrency Accepts a coin ID, exchange IDs and a sort order and returns coin trading pairs on centralized and decentralized exchanges. coingecko.openapi.get.coins.id.tickers
Get historical total cryptocurrency supply Accepts a coin ID, a history length in days and a bar interval and returns total coin supply over time. coingecko.openapi.get.coins.id.total_supply_chart
Get historical total cryptocurrency supply (date range) Accepts a coin ID, a start date and an end date and returns total coin supply over time. coingecko.openapi.get.coins.id.total_supply_chart.range
Get cryptocurrency category market data Accepts a sort order and returns coin categories with market capitalization and trading volume. coingecko.openapi.get.coins.categories
List cryptocurrency categories Returns supported cryptocurrency category names and identifiers without requiring input parameters. coingecko.openapi.get.coins.categories.list
List supported cryptocurrencies Accepts a request status and returns coin names, symbols and identifiers. coingecko.openapi.get.coins.list
List newly added cryptocurrencies Returns recently listed coin names, symbols and identifiers without requiring input parameters. coingecko.openapi.get.coins.list.new
Get market data for multiple cryptocurrencies Accepts a quote currency, coin IDs, coin names and ticker symbols and returns coin prices, market capitalization and trading volume. coingecko.openapi.get.coins.markets
Get the largest cryptocurrency price gains and losses Accepts a quote currency and a time window and returns coins with the largest percentage gains and losses. coingecko.openapi.get.coins.top_gainers_losers
List cryptocurrency derivatives tickers Returns derivatives trading pairs and market data without requiring input parameters. coingecko.openapi.get.derivatives
Get cryptocurrency derivatives exchange markets Accepts a sort order and returns derivatives exchanges with open interest and trading volume. coingecko.openapi.get.derivatives.exchanges
Get a cryptocurrency derivatives exchange Accepts an exchange ID and returns derivatives exchange metadata and market statistics. coingecko.openapi.get.derivatives.exchanges.id
List cryptocurrency derivatives exchanges Returns derivatives exchange names and identifiers without requiring input parameters. coingecko.openapi.get.derivatives.exchanges.list
List cryptocurrency treasury entities Accepts an entity type and returns supported public company and government entity identifiers. coingecko.openapi.get.entities.list
Get Bitcoin currency exchange rates Returns Bitcoin exchange rates against other currencies without requiring input parameters. coingecko.openapi.get.exchange_rates
Get cryptocurrency exchange market data Returns active exchange metadata and trading volume without requiring input parameters. coingecko.openapi.get.exchanges
Get a cryptocurrency exchange profile Accepts an exchange ID and returns exchange metadata, trading volume and top trading pairs. coingecko.openapi.get.exchanges.id
List a cryptocurrency exchange's trading pairs Accepts an exchange ID, coin IDs and a sort order and returns exchange trading pairs and market data. coingecko.openapi.get.exchanges.id.tickers
Get historical cryptocurrency exchange volume Accepts an exchange ID and a history length in days and returns exchange trading volume in Bitcoin over time. coingecko.openapi.get.exchanges.id.volume_chart
Get historical cryptocurrency exchange volume (date range) Accepts an exchange ID, a start date and an end date and returns exchange trading volume in Bitcoin over time. coingecko.openapi.get.exchanges.id.volume_chart.range
List cryptocurrency exchanges Accepts a request status and returns exchange names and identifiers. coingecko.openapi.get.exchanges.list
Get a cryptocurrency market overview Returns global cryptocurrency market capitalization and volume without requiring input parameters. coingecko.openapi.get.global
Get a decentralized finance market overview Returns DeFi market capitalization and trading volume without requiring input parameters. coingecko.openapi.get.global.decentralized_finance_defi
Get historical cryptocurrency market totals Accepts a history length in days and a quote currency and returns global cryptocurrency market capitalization and volume over time. coingecko.openapi.get.global.market_cap_chart
Get cryptocurrency insights Accepts a coin ID, a start date and an end date and returns published insights associated with cryptocurrencies. coingecko.openapi.get.insights
Get cryptocurrency news and guides Accepts a coin ID, a language and a retrieval type and returns cryptocurrency news articles and guides. coingecko.openapi.get.news
Get an NFT collection by contract address Accepts a blockchain network ID and a token contract address and returns NFT collection metadata, floor price and trading volume. coingecko.openapi.get.nfts.asset_platform_id.contract.contract_address
Get historical NFT markets by contract address Accepts a blockchain network ID, a token contract address and a history length in days and returns NFT floor price, market capitalization and volume over time. coingecko.openapi.get.nfts.asset_platform_id.contract.contract_address.market_chart
Get an NFT collection profile Accepts an NFT collection ID and returns NFT collection metadata, floor price and trading volume. coingecko.openapi.get.nfts.id
Get historical NFT collection market data Accepts an NFT collection ID and a history length in days and returns NFT floor price, market capitalization and volume over time. coingecko.openapi.get.nfts.id.market_chart
Get an NFT collection's marketplace prices Accepts an NFT collection ID and returns NFT collection floor prices and volume by marketplace. coingecko.openapi.get.nfts.id.tickers
List supported NFT collections Accepts a sort order and returns NFT collection identifiers, names and contract addresses. coingecko.openapi.get.nfts.list
Get market data for NFT collections Accepts a blockchain network ID and a sort order and returns NFT collection floor prices, market capitalization and volume. coingecko.openapi.get.nfts.markets
List onchain pool categories Returns supported onchain pool categories without requiring input parameters. coingecko.openapi.get.onchain.categories
List onchain pools in a category Accepts a category ID and returns onchain liquidity pools in a category. coingecko.openapi.get.onchain.categories.category_id.pools
List networks with onchain trading data Returns supported networks with onchain market data without requiring input parameters. coingecko.openapi.get.onchain.networks
Get a token's top traders Accepts a blockchain network ID, a token contract address and a trader count and returns top traders and their token trading statistics. coingecko.openapi.get.onchain.networks.network_id.tokens.token_address.top_traders
List decentralized exchanges on a network Accepts a blockchain network ID and returns its supported decentralized exchanges. coingecko.openapi.get.onchain.networks.network.dexes
Get a decentralized exchange's top pools Accepts a network ID and decentralized exchange ID and returns the exchange's top liquidity pools. coingecko.openapi.get.onchain.networks.network.dexes.dex.pools
List new liquidity pools on a network Accepts a blockchain network ID and returns newly created liquidity pools on that network. coingecko.openapi.get.onchain.networks.network.new_pools
Get a network's top liquidity pools Accepts a blockchain network ID and returns its top liquidity pools. coingecko.openapi.get.onchain.networks.network.pools
Get an onchain liquidity pool Accepts a blockchain network ID and a pool contract address and returns liquidity pool market data. coingecko.openapi.get.onchain.networks.network.pools.address
Get the tokens in an onchain liquidity pool Accepts a blockchain network ID and a pool contract address and returns base and quote token metadata for a liquidity pool. coingecko.openapi.get.onchain.networks.network.pools.pool_address.info
List a pool's liquidity changes Accepts a blockchain network ID, a pool contract address, a liquidity event type and a minimum trade value in US dollars and returns liquidity additions and removals from a pool. coingecko.openapi.get.onchain.networks.network.pools.pool_address.liquidity_events
Get multiple onchain liquidity pools Accepts a blockchain network ID and pool contract addresses and returns market data for multiple liquidity pools. coingecko.openapi.get.onchain.networks.network.pools.multi.addresses
Get onchain token market data Accepts a blockchain network ID and a token contract address and returns onchain token price and market statistics. coingecko.openapi.get.onchain.networks.network.tokens.address
Get onchain token metadata Accepts a blockchain network ID and a token contract address and returns token name, symbol, links and contract metadata. coingecko.openapi.get.onchain.networks.network.tokens.address.info
Get a token's largest holders Accepts a blockchain network ID, a token contract address and a holder count and returns top token holders and their balances. coingecko.openapi.get.onchain.networks.network.tokens.address.top_holders
Get historical token holder counts Accepts a blockchain network ID, a token contract address and a history length in days and returns token holder counts over time. coingecko.openapi.get.onchain.networks.network.tokens.token_address.holders_chart
Get onchain token price and volume bars Accepts a blockchain network ID, a token contract address, a bar timeframe and a bar aggregation size and returns token open, high, low, close and volume bars. coingecko.openapi.get.onchain.networks.network.tokens.token_address.ohlcv.timeframe
Get a token's top liquidity pools Accepts a blockchain network ID and a token contract address and returns top liquidity pools trading a token. coingecko.openapi.get.onchain.networks.network.tokens.token_address.pools
List onchain token trades Accepts a blockchain network ID, a token contract address, a minimum trade value in US dollars and a trading period and returns token trades across liquidity pools. coingecko.openapi.get.onchain.networks.network.tokens.token_address.trades
List onchain token trades (date range) Accepts a blockchain network ID, a token contract address, a minimum trade value in US dollars and a start date and returns token trades across liquidity pools in a time range. coingecko.openapi.get.onchain.networks.network.tokens.token_address.trades.range
Get market data for multiple onchain tokens Accepts a blockchain network ID and token contract addresses and returns onchain market data for multiple tokens. coingecko.openapi.get.onchain.networks.network.tokens.multi.addresses
Get trending liquidity pools on a network Accepts a blockchain network ID and time window and returns its trending liquidity pools. coingecko.openapi.get.onchain.networks.network.trending_pools
List new liquidity pools across networks Returns new liquidity pools across blockchain networks without requiring input parameters. coingecko.openapi.get.onchain.networks.new_pools
Get trending liquidity pools across networks Accepts a time window and returns trending liquidity pools across blockchain networks. coingecko.openapi.get.onchain.networks.trending_pools
Filter onchain liquidity pools Accepts network IDs, exchange IDs and market or liquidity ranges and returns liquidity pools matching market and liquidity criteria. coingecko.openapi.get.onchain.pools.megafilter
Get frequently searched liquidity pools Accepts pools and returns liquidity pools trending in search across networks. coingecko.openapi.get.onchain.pools.trending_search
Search onchain liquidity pools Accepts a search query and a blockchain network ID and returns liquidity pools matching a token name, symbol or address. coingecko.openapi.get.onchain.search.pools
Get token prices by contract address Accepts a network ID and token contract addresses and returns their prices. coingecko.openapi.get.onchain.simple.networks.network.token_price.addresses
Get token prices across blockchain networks Accepts token addresses and their network IDs and returns prices for tokens on multiple blockchain networks. coingecko.openapi.get.onchain.simple.token_price.multi
List tokens with recently updated metadata Accepts a blockchain network ID and returns recently updated token metadata. coingecko.openapi.get.onchain.tokens.info_recently_updated
Get token market data across blockchain networks Accepts token addresses and their network IDs and returns token market data across multiple blockchain networks. coingecko.openapi.get.onchain.tokens.multi
Get a wallet's token balances Accepts a wallet address, blockchain network IDs, a token type and a minimum value in US dollars and returns wallet token balances across blockchain networks. coingecko.openapi.get.onchain.wallets.address.balances
Get a cryptocurrency wallet's profit and loss Accepts a wallet address and blockchain network IDs and returns wallet profit and loss statistics across networks. coingecko.openapi.get.onchain.wallets.address.pnl
Get an entity's cryptocurrency treasury holdings Accepts an entity ID and returns cryptocurrency treasury holdings for the public company or government. coingecko.openapi.get.public_treasury.entity_id
Get historical cryptocurrency treasury holdings Accepts an entity ID, a coin ID and a history length in days and returns an entity's cryptocurrency holdings over time. coingecko.openapi.get.public_treasury.entity_id.coin_id.holding_chart
List an entity's cryptocurrency treasury transactions Accepts an entity ID, a sort order and coin IDs and returns cryptocurrency treasury transactions for an entity. coingecko.openapi.get.public_treasury.entity_id.transaction_history
Get a tokenized real world asset Accepts a tokenized asset ID and token addresses and their network IDs and returns tokenized real world asset metadata, tokens and market data. coingecko.openapi.get.rwas.id
Get historical markets for a tokenized real world asset Accepts a tokenized asset ID, a history length in days and a bar interval and returns tokenized asset prices, market capitalization and volume over time. coingecko.openapi.get.rwas.id.market_chart
List trading pairs for a tokenized real world asset Accepts a tokenized asset ID, issuer IDs, exchange IDs and a sort order and returns trading pairs for tokens representing a real world asset. coingecko.openapi.get.rwas.id.tickers
Get a tokenized asset issuer's market data Accepts an issuer ID and returns an issuer's tokens, market capitalization and volume. coingecko.openapi.get.rwas.issuers.id
List tokenized real world asset issuers Returns supported issuers of tokenized real world assets without requiring input parameters. coingecko.openapi.get.rwas.issuers.list
List tokenized real world assets Accepts an asset type and returns tokenized real world asset names, symbols and identifiers. coingecko.openapi.get.rwas.list
Get market data for tokenized real world assets Accepts an asset type, coin IDs, coin names and ticker symbols and returns tokenized asset prices, market capitalization and trading volume. coingecko.openapi.get.rwas.markets
Search cryptocurrencies, categories and exchanges Accepts a search query and returns matching cryptocurrencies, market categories and exchanges. coingecko.openapi.get.search
Get trending cryptocurrencies, NFTs and categories Returns cryptocurrencies, NFTs and categories trending in search without requiring input parameters. coingecko.openapi.get.search.trending
Get cryptocurrency prices Accepts coin IDs, symbols or names and quote currencies and returns prices for one or more cryptocurrencies. coingecko.openapi.get.simple.price
List cryptocurrency quote currencies Returns supported currencies for cryptocurrency price quotes without requiring input parameters. coingecko.openapi.get.simple.supported_vs_currencies
Get cryptocurrency prices by token contract Accepts a tokenized asset ID, token contract addresses and quote currencies and returns token prices in the requested quote currencies. coingecko.openapi.get.simple.token_price.id
List a blockchain network's tokens Accepts a blockchain network ID and returns its supported tokens in Ethereum token list format. coingecko.openapi.get.token_lists.asset_platform_id.all.json

CoinGecko 1

Function Price
Check CoinGecko server status Returns the current CoinGecko server status without requiring input parameters. coingecko.openapi.get.ping
Included in the applicable market-data subscription or free quota; entitlement and usage limits vary by endpoint. No standalone PAYG unit rate published.

Prices are CoinGecko's published rates. Source: CoinGecko pricing.

Use cases

Questions people ask

How do I get a CoinGecko API key?

Sign in to CoinGecko and create a key at www.coingecko.com/en/developers/dashboard. Add it once in Longwave settings and your agents' CoinGecko calls run on your own account. CoinGecko API keys

Do I need a CoinGecko account?

Yes. Create a key at https://www.coingecko.com/en/developers/dashboard and add it in Longwave settings. Longwave stores it encrypted and uses it only for your calls.

How do I use CoinGecko in Claude Code?

Add the Longwave MCP server once with claude mcp add --transport http longwave https://api.longwave.run/v1/mcp/tasks, sign in, and ask for what you need. Claude finds the right CoinGecko function and calls it.

Use CoinGecko in Longwave

Ask any Longwave thread for the result, or add Longwave to Claude Code, Codex, Cursor or ChatGPT.

Add to Longwave