The CoinGecko connector lets your AI agent act in each user's CoinGecko account. Each user connects their own CoinGecko API key once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 38 tools.
- Tools
- 38
- What they doRead · write · destructive
- 38 · 0 · 038 read0 write0 destructive
- Users sign in with
- API key
Setup
Install the SDK
Terminal window npm install @scalekit-sdk/node dotenvTerminal window pip install scalekit-sdk-python python-dotenvSet your credentials
Add your Scalekit credentials to your
.envfile. Find values in app.scalekit.com > Developers > API Credentials..env SCALEKIT_ENVIRONMENT_URL=<your-environment-url>SCALEKIT_CLIENT_ID=<your-client-id>SCALEKIT_CLIENT_SECRET=<your-client-secret>Create the CoinGecko connection
In AgentKit > Connections, create a CoinGecko connection. The name you give it is the
connection_nameyour code passes. See Configure connections.Authorize a user and make your first call
quickstart.mts import { ScalekitClient } from '@scalekit-sdk/node'import 'dotenv/config'import { createInterface } from 'node:readline/promises'const scalekit = new ScalekitClient(process.env.SCALEKIT_ENVIRONMENT_URL,process.env.SCALEKIT_CLIENT_ID,process.env.SCALEKIT_CLIENT_SECRET,)const actions = scalekit.actionsconst connector = 'coingecko'const identifier = 'user_123'// Generate an authorization link for the userconst { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })console.log('Authorize CoinGecko:', link)const rl = createInterface({ input: process.stdin, output: process.stdout })await rl.question('Press Enter after authorizing...')rl.close()// Make your first callconst result = await actions.executeTool({connector,identifier,toolName: 'coingecko_get_exchange_rates',toolInput: {},})console.log(result)Terminal window npx tsx quickstart.mtsquickstart.py import osfrom scalekit import ScalekitClientfrom dotenv import load_dotenvload_dotenv()scalekit_client = ScalekitClient(env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),client_id=os.getenv("SCALEKIT_CLIENT_ID"),client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),)actions = scalekit_client.actionsconnection_name = "coingecko"identifier = "user_123"# Generate an authorization link for the userlink_response = actions.get_authorization_link(connection_name=connection_name,identifier=identifier,)print("Authorize CoinGecko:", link_response.link)input("Press Enter after authorizing...")# Make your first callresult = actions.execute_tool(tool_input={},tool_name="coingecko_get_exchange_rates",connection_name=connection_name,identifier=identifier,)print(result)Terminal window python quickstart.pyEach user opens the link once and enters their CoinGecko credentials there. See Authorize a user for the full flow and statuses.
Tools
Pass the exact name toexecute_toolcoingecko_get_coinGet the full profile of one coin by CoinGecko coin ID: metadata and live market data.Read-onlyGet Coin
Get the full profile of one coin by CoinGecko coin ID: metadata and live market data. Returns name, symbol, description, links, image, categories, contract addresses per platform, genesis date, market_data (price, market cap and volume in every currency, ATH/ATL, supply, price changes) and up to 100 exchange tickers. Use coingecko_get_coin for everything about one coin. Use coingecko_get_simple_price for price only, coingecko_get_coin_by_contract when you only have a contract address, and coingecko_get_coin_tickers for more than 100 tickers.
Inputs
coin_idstringrequired- CoinGecko coin API ID, for example bitcoin or ethereum. This is the id from coingecko_list_coins or coingecko_search, not the ticker symbol.
dex_pair_formatstring- How DEX ticker pairs show base and target: contract_address (default) or symbol, for example WETH/USDC.one of
contract_addresssymbol include_categories_detailsboolean- Set to true to add category IDs and names in categories_details. Default false.
localizationboolean- Set to false to drop the localized names and descriptions in every language, which shrinks the response a lot. Default true.
market_databoolean- Set to false to leave out market_data. Default true.
sparklineboolean- Set to true to add 7-day sparkline price data. Default false.
tickersboolean- Set to false to leave out exchange tickers. Default true.
coingecko_get_coin_by_contractGet the full profile of a token by its blockchain and contract address.Read-onlyGet Coin by Contract
Get the full profile of a token by its blockchain and contract address. Returns the same coin profile as coingecko_get_coin: metadata, links, categories, contract addresses, market_data and up to 100 tickers. Use coingecko_get_coin_by_contract when you only have a contract address. Use coingecko_get_coin when you have the coin ID, and coingecko_get_token_price for price only.
Inputs
asset_platform_idstringrequired- CoinGecko asset platform (blockchain) ID, for example ethereum, solana or binance-smart-chain. Valid IDs come from coingecko_list_asset_platforms.
contract_addressstringrequired- The token's contract address on that platform, for example 0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2 (WETH on Ethereum).
coingecko_get_coin_historyGet a snapshot of one coin's price, market cap and 24-hour volume on a past date, taken at 00:00 UTC.Read-onlyGet Coin History
Get a snapshot of one coin's price, market cap and 24-hour volume on a past date, taken at 00:00 UTC. Returns the coin's id, symbol, name, image and market_data with current_price, market_cap and total_volume in every currency for that date. Demo keys only reach the past 365 days. Use coingecko_get_coin_history for a single past day. Use coingecko_get_coin_market_chart_range for a series over a period.
Inputs
coin_idstringrequired- CoinGecko coin API ID, for example bitcoin or ethereum. This is the id from coingecko_list_coins or coingecko_search, not the ticker symbol.
datestringrequired- The day to snapshot, in dd-mm-yyyy format, for example 30-12-2025. Must be within the past 365 days on Demo keys.
localizationboolean- Set to false to drop localized names in every language. Default true.
coingecko_get_coin_market_chartGet a coin's historical price, market cap and 24-hour volume for the last N days, by CoinGecko coin ID.Read-onlyGet Coin Market Chart
Get a coin's historical price, market cap and 24-hour volume for the last N days, by CoinGecko coin ID. Returns arrays prices, market_caps and total_volumes of [UNIX ms, value] points. Granularity is automatic: 5-minutely for 1 day, hourly for 2-90 days, daily beyond, unless interval is set. Demo keys only reach the past 365 days. Use coingecko_get_coin_market_chart for 'last N days'. Use coingecko_get_coin_market_chart_range for exact start and end dates, coingecko_get_coin_ohlc for candles, and coingecko_get_coin_history for a single day's snapshot.
Inputs
coin_idstringrequired- CoinGecko coin API ID, for example bitcoin or ethereum. This is the id from coingecko_list_coins or coingecko_search, not the ticker symbol.
daysstringrequired- How many days back from now to return: any whole number such as 1, 30 or 365. Demo keys are limited to 365 days; max (full history) needs a paid plan.
vs_currencystringrequired- Currency to express prices and market data in, for example usd, eur or btc. Valid values come from coingecko_list_supported_vs_currencies.
intervalstring- Force the data interval: daily (one point per day at 00:00 UTC) or hourly (only for ranges within 100 days). Omit for automatic granularity.one of
hourlydaily precisionstring- Number of decimal places for price values, 0 to 18, or full for no rounding. Omit for CoinGecko's default rounding.one of
full0123456789101112131415161718
coingecko_get_coin_market_chart_rangeGet a coin's historical price, market cap and 24-hour volume between two dates, by CoinGecko coin ID.Read-onlyGet Coin Market Chart Range
Get a coin's historical price, market cap and 24-hour volume between two dates, by CoinGecko coin ID. Returns arrays prices, market_caps and total_volumes of [UNIX ms, value] points. Granularity is automatic (5-minutely within the last day, hourly up to 90 days, daily beyond) unless interval is set. Demo keys only reach the past 365 days. Use coingecko_get_coin_market_chart_range for a fixed window. Use coingecko_get_coin_market_chart for 'last N days' and coingecko_get_contract_market_chart_range when you only have a contract address.
Inputs
coin_idstringrequired- CoinGecko coin API ID, for example bitcoin or ethereum. This is the id from coingecko_list_coins or coingecko_search, not the ticker symbol.
fromstringrequired- Start of the range, as a UNIX timestamp in seconds (for example 1767225600) or an ISO date YYYY-MM-DD or YYYY-MM-DDTHH:MM (for example 2026-01-01). Must be within the past 365 days on Demo keys.
tostringrequired- End of the range, as a UNIX timestamp in seconds (for example 1769904000) or an ISO date YYYY-MM-DD or YYYY-MM-DDTHH:MM (for example 2026-02-01).
vs_currencystringrequired- Currency to express prices and market data in, for example usd, eur or btc. Valid values come from coingecko_list_supported_vs_currencies.
intervalstring- Force the data interval: daily (one point per day at 00:00 UTC) or hourly (only for ranges within 100 days). Omit for automatic granularity.one of
hourlydaily precisionstring- Number of decimal places for price values, 0 to 18, or full for no rounding. Omit for CoinGecko's default rounding.one of
full0123456789101112131415161718
coingecko_get_coin_ohlcGet open, high, low and close price candles for a coin over the last N days, by CoinGecko coin ID.Read-onlyGet Coin OHLC
Get open, high, low and close price candles for a coin over the last N days, by CoinGecko coin ID. Returns an array of [UNIX ms close time, open, high, low, close]. Candle size is automatic: 30 minutes for 1-2 days, 4 hours for 7-30 days, 4 days beyond. Demo keys only reach the past 365 days. Use coingecko_get_coin_ohlc for candlestick charts. Use coingecko_get_coin_market_chart for finer price points with market cap and volume.
Inputs
coin_idstringrequired- CoinGecko coin API ID, for example bitcoin or ethereum. This is the id from coingecko_list_coins or coingecko_search, not the ticker symbol.
daysstringrequired- How many days back from now to return: 1, 7, 14, 30, 90, 180 or 365.one of
17143090180365 vs_currencystringrequired- Currency to express prices and market data in, for example usd, eur or btc. Valid values come from coingecko_list_supported_vs_currencies.
precisionstring- Number of decimal places for price values, 0 to 18, or full for no rounding. Omit for CoinGecko's default rounding.one of
full0123456789101112131415161718
coingecko_get_coin_tickersList where a coin trades: its tickers on centralized and decentralized exchanges, 100 per page.Read-onlyGet Coin Tickers
List where a coin trades: its tickers on centralized and decentralized exchanges, 100 per page. Returns the coin name and a tickers array with exchange, base, target, last price, volume, converted price and volume, spread, trust score, trade URL and optional 2% order-book depth. Use coingecko_get_coin_tickers for one coin across exchanges. Use coingecko_get_exchange_tickers for every pair on one exchange.
Inputs
coin_idstringrequired- CoinGecko coin API ID, for example bitcoin or ethereum. This is the id from coingecko_list_coins or coingecko_search, not the ticker symbol.
depthboolean- Set to true to add 2% order-book depth (cost_to_move_up_usd and cost_to_move_down_usd). Default false.
dex_pair_formatstring- How DEX ticker pairs show base and target: contract_address (default) or symbol, for example WETH/USDC.one of
contract_addresssymbol exchange_idsstring- Only return tickers on these exchanges, by CoinGecko exchange ID, for example binance.
include_exchange_logoboolean- Set to true to add each exchange's logo URL. Default false.
orderstring- Sort order. Default trust_score_desc. Volume sorts use converted volume.one of
trust_score_desctrust_score_ascvolume_descvolume_asc pageinteger- Page number, starting at 1; each page holds 100 tickers.
coingecko_get_contract_market_chartGet a token's historical price, market cap and 24-hour volume for the last N days, looked up by blockchain and contract address.Read-onlyGet Contract Market Chart
Get a token's historical price, market cap and 24-hour volume for the last N days, looked up by blockchain and contract address. Returns arrays prices, market_caps and total_volumes of [UNIX ms, value] points, with the same automatic granularity as coingecko_get_coin_market_chart. Demo keys only reach the past 365 days. Use coingecko_get_contract_market_chart when you only have a contract address. Use coingecko_get_coin_market_chart when you have the coin ID, and coingecko_get_contract_market_chart_range for exact dates.
Inputs
asset_platform_idstringrequired- CoinGecko asset platform (blockchain) ID, for example ethereum, solana or binance-smart-chain. Valid IDs come from coingecko_list_asset_platforms.
contract_addressstringrequired- The token's contract address on that platform, for example 0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48 (USDC on Ethereum).
daysstringrequired- How many days back from now to return: any whole number such as 1, 30 or 365. Demo keys are limited to 365 days.
vs_currencystringrequired- Currency to express prices and market data in, for example usd, eur or btc. Valid values come from coingecko_list_supported_vs_currencies.
intervalstring- Force the data interval: daily (one point per day at 00:00 UTC) or hourly (only for ranges within 100 days). Omit for automatic granularity.one of
hourlydaily precisionstring- Number of decimal places for price values, 0 to 18, or full for no rounding. Omit for CoinGecko's default rounding.one of
full0123456789101112131415161718
coingecko_get_contract_market_chart_rangeGet a token's historical price, market cap and 24-hour volume between two dates, looked up by blockchain and contract address.Read-onlyGet Contract Market Chart Range
Get a token's historical price, market cap and 24-hour volume between two dates, looked up by blockchain and contract address. Returns arrays prices, market_caps and total_volumes of [UNIX ms, value] points with automatic granularity. Demo keys only reach the past 365 days. Use coingecko_get_contract_market_chart_range for a fixed window by contract address. Use coingecko_get_coin_market_chart_range when you have the coin ID.
Inputs
asset_platform_idstringrequired- CoinGecko asset platform (blockchain) ID, for example ethereum, solana or binance-smart-chain. Valid IDs come from coingecko_list_asset_platforms.
contract_addressstringrequired- The token's contract address on that platform, for example 0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48 (USDC on Ethereum).
fromstringrequired- Start of the range, as a UNIX timestamp in seconds (for example 1767225600) or an ISO date YYYY-MM-DD or YYYY-MM-DDTHH:MM (for example 2026-01-01). Must be within the past 365 days on Demo keys.
tostringrequired- End of the range, as a UNIX timestamp in seconds (for example 1769904000) or an ISO date YYYY-MM-DD or YYYY-MM-DDTHH:MM (for example 2026-02-01).
vs_currencystringrequired- Currency to express prices and market data in, for example usd, eur or btc. Valid values come from coingecko_list_supported_vs_currencies.
precisionstring- Number of decimal places for price values, 0 to 18, or full for no rounding. Omit for CoinGecko's default rounding.one of
full0123456789101112131415161718
coingecko_get_derivatives_exchangeGet one derivatives exchange's details by CoinGecko derivatives exchange ID, optionally with its tickers.Read-onlyGet Derivatives Exchange
Get one derivatives exchange's details by CoinGecko derivatives exchange ID, optionally with its tickers. Returns name, open interest and 24-hour volume in BTC, number of perpetual and futures pairs, year established, country, description and URL, plus tickers when include_tickers is set. Use coingecko_get_derivatives_exchange for derivatives venues such as binance_futures. Use coingecko_get_exchange for spot exchanges.
Inputs
exchange_idstringrequired- CoinGecko derivatives exchange ID, for example binance_futures or bybit. Find IDs with coingecko_list_derivatives_exchanges.
include_tickersstring- Add tickers: all for every contract, or unexpired for contracts that have not expired. Omit to leave tickers out.one of
allunexpired
coingecko_get_exchangeGet one spot exchange's details by CoinGecko exchange ID.Read-onlyGet Exchange
Get one spot exchange's details by CoinGecko exchange ID. Returns name, year established, country, description, URLs and social links, trust score and rank, 24-hour volume in BTC and the top 100 tickers. Use coingecko_get_exchange for an exchange profile. Use coingecko_get_exchange_tickers for all of its trading pairs, and coingecko_get_derivatives_exchange for derivatives venues such as binance_futures.
Inputs
exchange_idstringrequired- CoinGecko exchange ID, for example binance or gdax. Valid IDs come from coingecko_list_exchange_ids.
dex_pair_formatstring- How DEX ticker pairs show base and target: contract_address (default) or symbol, for example WETH/USDC.one of
contract_addresssymbol
coingecko_get_exchange_ratesGet BTC exchange rates against fiat currencies, crypto and commodities.Read-onlyGet Exchange Rates
Get BTC exchange rates against fiat currencies, crypto and commodities. Returns a rates object keyed by currency code, each with name, unit, value (units per 1 BTC) and type (fiat, crypto or commodity). Use coingecko_get_exchange_rates to convert BTC-denominated figures, such as exchange volumes, into other currencies.
Inputs
This tool takes no inputs.
coingecko_get_exchange_tickersList the trading pairs (tickers) on one exchange, 100 per page, optionally only for given coins.Read-onlyGet Exchange Tickers
List the trading pairs (tickers) on one exchange, 100 per page, optionally only for given coins. Returns the exchange name and a tickers array with base, target, last price, volume, converted price and volume, bid-ask spread, trust score, trade URL and optional 2% order-book depth. Use coingecko_get_exchange_tickers to see what trades on an exchange. Use coingecko_get_coin_tickers to see where one coin trades across exchanges.
Inputs
exchange_idstringrequired- CoinGecko exchange ID, for example binance. Valid IDs come from coingecko_list_exchange_ids.
coin_idsstring- Only return tickers for these CoinGecko coin IDs, comma-separated, for example bitcoin,ethereum.
depthboolean- Set to true to add 2% order-book depth (cost_to_move_up_usd and cost_to_move_down_usd). Default false.
dex_pair_formatstring- How DEX ticker pairs show base and target: contract_address (default) or symbol, for example WETH/USDC.one of
contract_addresssymbol include_exchange_logoboolean- Set to true to add the exchange logo URL. Default false.
orderstring- Sort order. Default trust_score_desc. Use base_target for stable pagination across pages.one of
market_cap_ascmarket_cap_desctrust_score_desctrust_score_ascvolume_descvolume_ascbase_target pageinteger- Page number, starting at 1; each page holds 100 tickers.
coingecko_get_exchange_volume_chartGet an exchange's historical trading volume, in BTC, for the last N days.Read-onlyGet Exchange Volume Chart
Get an exchange's historical trading volume, in BTC, for the last N days. Returns an array of [UNIX ms, volume in BTC] points. Use coingecko_get_exchange_volume_chart to track an exchange's activity over time. Use coingecko_get_exchange for its current 24-hour volume.
Inputs
daysstringrequired- How many days back from now to return: 1, 7, 14, 30, 90, 180 or 365.one of
17143090180365 exchange_idstringrequired- CoinGecko exchange ID or derivatives exchange ID, for example binance or binance_futures.
coingecko_get_globalGet global cryptocurrency market statistics.Read-onlyGet Global Market Data
Get global cryptocurrency market statistics. Returns the number of active coins and markets, total market cap and 24-hour volume in every currency, market cap dominance by coin (for example btc and eth percentages), the 24-hour market cap change and the update time. Use coingecko_get_global for whole-market figures. Use coingecko_get_global_defi for DeFi-only figures and coingecko_list_categories for per-sector figures.
Inputs
This tool takes no inputs.
coingecko_get_global_defiGet global decentralized finance (DeFi) market statistics, based on the top 100 DeFi coins.Read-onlyGet Global DeFi Data
Get global decentralized finance (DeFi) market statistics, based on the top 100 DeFi coins. Returns DeFi market cap, ETH market cap, the DeFi-to-ETH ratio, 24-hour trading volume, DeFi dominance, and the top DeFi coin with its dominance. Use coingecko_get_global_defi for DeFi-only figures. Use coingecko_get_global for the whole crypto market.
Inputs
This tool takes no inputs.
coingecko_get_nftGet one NFT collection's data by CoinGecko NFT ID.Read-onlyGet NFT Collection
Get one NFT collection's data by CoinGecko NFT ID. Returns name, symbol, asset platform, contract address, description, links, floor price, market cap and 24-hour volume (native and USD) with their 24-hour changes, owners, total supply, and floor-price changes over several periods. Use coingecko_get_nft when you have the collection ID. Use coingecko_get_nft_by_contract when you only have the contract address, and coingecko_list_nfts to find IDs.
Inputs
nft_idstringrequired- CoinGecko NFT collection ID, for example pudgy-penguins. Valid IDs come from coingecko_list_nfts.
coingecko_get_nft_by_contractGet one NFT collection's data by its blockchain and contract address.Read-onlyGet NFT Collection by Contract
Get one NFT collection's data by its blockchain and contract address. Returns the same collection data as coingecko_get_nft: floor price, market cap, 24-hour volume and their changes, owners, supply and links. Use coingecko_get_nft_by_contract when you only have the contract address. Use coingecko_get_nft when you have the CoinGecko NFT ID.
Inputs
asset_platform_idstringrequired- CoinGecko asset platform (blockchain) ID, for example ethereum, solana or binance-smart-chain. Valid IDs come from coingecko_list_asset_platforms. Use coingecko_list_asset_platforms with filter=nft to see platforms that have NFTs.
contract_addressstringrequired- The NFT collection's contract address on that platform, for example 0xBd3531dA5CF5857e7CfAA92426877b022e612cf8 (Pudgy Penguins).
coingecko_get_onchain_token_priceGet the current USD price of tokens on one network from GeckoTerminal DEX pools, by contract address.Read-onlyGet Onchain Token Price
Get the current USD price of tokens on one network from GeckoTerminal DEX pools, by contract address. Returns a JSON:API object whose token_prices map each contract address to a USD price, plus market cap, 24-hour volume, 24-hour price change and total reserve when asked. Addresses GeckoTerminal does not know are left out. Use coingecko_get_onchain_token_price for DEX-traded tokens, including ones CoinGecko does not list. Use coingecko_get_token_price for CoinGecko's aggregated price in any currency.
Inputs
addressesstringrequired- Token contract addresses on that network, comma-separated, up to 30 on Demo keys.
networkstringrequired- GeckoTerminal network ID, for example eth, solana or base. Valid IDs come from coingecko_list_onchain_networks.
include_24hr_price_changeboolean- Set to true to add the 24-hour price change percentage. Default false.
include_24hr_volboolean- Set to true to add 24-hour volume. Default false.
include_inactive_sourceboolean- Set to true to fall back to recently active pools (up to 1 year) when no top pool is found. Default false.
include_market_capboolean- Set to true to add market cap (null for unverified tokens unless mcap_fdv_fallback is true). Default false.
include_total_reserve_in_usdboolean- Set to true to add total liquidity reserve in USD. Default false.
mcap_fdv_fallbackboolean- Set to true to return fully diluted valuation when market cap is unavailable. Default false.
coingecko_get_public_treasuryList public companies or governments that hold a coin in their treasury, largest holdings first.Read-onlyGet Public Treasury Holdings
List public companies or governments that hold a coin in their treasury, largest holdings first. Returns the total holdings and total value in USD, the share of the coin's supply held (market_cap_dominance), and a companies or governments array with name, symbol, country, total_holdings, total entry value in USD, current value in USD and percentage of supply. Use coingecko_get_public_treasury for corporate or government holdings of bitcoin, ethereum or another supported coin.
Inputs
coin_idstringrequired- CoinGecko coin ID of the treasury asset, for example bitcoin, ethereum, solana or binancecoin.
entitystringrequired- Whose holdings to list: companies (public companies) or governments.one of
companiesgovernments orderstring- Sort order. Default total_holdings_usd_desc.one of
total_holdings_usd_desctotal_holdings_usd_asc pageinteger- Page number to return, starting at 1. Omit for page 1.
per_pageinteger- Number of results per page, 1 to 250. Omit for CoinGecko's default of 250.
coingecko_get_simple_priceGet the current price of one or more coins in one or more currencies, looked up by CoinGecko coin ID, name or symbol.Read-onlyGet Simple Price
Get the current price of one or more coins in one or more currencies, looked up by CoinGecko coin ID, name or symbol. Returns an object keyed by coin ID with a price per requested currency, plus market cap, 24-hour volume, 24-hour change and last-updated time when asked. With include_tokens=all the object is keyed by symbol instead, each holding an array of matching coins with their id, name and prices. Use coingecko_get_simple_price for quick price checks. Use coingecko_get_token_price to look up tokens by contract address, and coingecko_list_coins_markets for ranked lists with full market data.
Inputs
vs_currenciesstringrequired- Currencies to price the coins in, comma-separated, for example usd or usd,eur,btc. Valid values come from coingecko_list_supported_vs_currencies.
idsstring- CoinGecko coin IDs, comma-separated, for example bitcoin,ethereum (up to 515). Provide ids, names or symbols; if several are given, ids wins, then names, then symbols.
include_24hr_changeboolean- Set to true to add the 24-hour price change percentage for each currency (null when the price is stale). Default false.
include_24hr_volboolean- Set to true to add 24-hour trading volume for each currency. Default false.
include_last_updated_atboolean- Set to true to add last_updated_at, the UNIX time of the latest price. Default false.
include_market_capboolean- Set to true to add market capitalization for each currency. Default false.
include_tokensstring- For lookups by symbols only: top (default) returns the top-ranked coin per symbol; all returns every coin sharing the symbol (up to 50 symbols). Send all only with symbols and with ids and names left empty; otherwise CoinGecko rejects the request with 400.one of
topall namesstring- Coin names, comma-separated, for example Bitcoin,Ethereum. Used when ids is empty.
precisionstring- Number of decimal places for price values, 0 to 18, or full for no rounding. Omit for CoinGecko's default rounding.one of
full0123456789101112131415161718 symbolsstring- Ticker symbols, comma-separated, for example btc,eth. Used when ids and names are empty. Symbols are ambiguous: by default only the top-ranked coin per symbol is returned (see include_tokens).
coingecko_get_token_priceGet the current price of one or more tokens on a blockchain, looked up by contract address.Read-onlyGet Token Price by Contract
Get the current price of one or more tokens on a blockchain, looked up by contract address. Returns an object keyed by contract address with a price per requested currency, plus market cap, 24-hour volume, 24-hour change and last-updated time when asked. The price is CoinGecko's global average across exchanges. Use coingecko_get_token_price when you have a contract address. Use coingecko_get_simple_price for coin IDs or symbols, and coingecko_get_onchain_token_price for a DEX-pool price of a token CoinGecko does not list.
Inputs
asset_platform_idstringrequired- CoinGecko asset platform (blockchain) ID, for example ethereum, solana or binance-smart-chain. Valid IDs come from coingecko_list_asset_platforms.
contract_addressesstringrequired- Token contract addresses on that platform, comma-separated (up to 515), for example 0x2260fac5e5542a773aa44fbcfedf7c193bc2c599.
vs_currenciesstringrequired- Currencies to price the tokens in, comma-separated, for example usd or usd,eth. Valid values come from coingecko_list_supported_vs_currencies.
include_24hr_changeboolean- Set to true to add the 24-hour price change percentage for each currency. Default false.
include_24hr_volboolean- Set to true to add 24-hour trading volume for each currency. Default false.
include_last_updated_atboolean- Set to true to add last_updated_at, the UNIX time of the latest price. Default false.
include_market_capboolean- Set to true to add market capitalization for each currency. Default false.
precisionstring- Number of decimal places for price values, 0 to 18, or full for no rounding. Omit for CoinGecko's default rounding.one of
full0123456789101112131415161718
coingecko_get_trendingGet what is trending on CoinGecko in the last 24 hours.Read-onlyGet Trending
Get what is trending on CoinGecko in the last 24 hours. Returns the top 15 trending coins by search popularity (with price and market data), the top 7 trending NFT collections by floor-price change, and the top 5 trending categories. Use coingecko_get_trending for what people are watching now. Use coingecko_list_coins_markets for rankings by market cap or volume.
Inputs
This tool takes no inputs.
coingecko_list_asset_platformsList the blockchains (asset platforms) CoinGecko supports.Read-onlyList Asset Platforms
List the blockchains (asset platforms) CoinGecko supports. Returns an array of platforms with id, chain_identifier (EVM chain ID), name, shortname, native_coin_id and image. Use coingecko_list_asset_platforms to find asset_platform_id values for the token-price, contract and NFT-contract tools.
Inputs
filterstring- Set to nft to return only platforms that have NFT collections on CoinGecko.one of
nft
coingecko_list_categoriesList coin categories (sectors such as Layer 1, DeFi or Meme) with their market data.Read-onlyList Categories
List coin categories (sectors such as Layer 1, DeFi or Meme) with their market data. Returns an array of categories with id, name, market_cap, 24-hour market cap change, 24-hour volume, top 3 coin images and the update time. Use coingecko_list_categories to compare sectors. Use coingecko_list_category_ids for the plain ID list and coingecko_list_coins_markets with category to list the coins in one category.
Inputs
orderstring- Sort order. Default market_cap_desc.one of
market_cap_descmarket_cap_ascname_descname_ascmarket_cap_change_24h_descmarket_cap_change_24h_asc
coingecko_list_category_idsList every coin category's CoinGecko ID and name, without market data.Read-onlyList Category IDs
List every coin category's CoinGecko ID and name, without market data. Returns an array of {category_id, name}. Use coingecko_list_category_ids to find the category value for coingecko_list_coins_markets. Use coingecko_list_categories for categories with market cap and volume.
Inputs
This tool takes no inputs.
coingecko_list_coinsList every coin CoinGecko tracks, with its API ID, symbol and name, in one unpaginated response.Read-onlyList Coins
List every coin CoinGecko tracks, with its API ID, symbol and name, in one unpaginated response. Returns an array of {id, symbol, name}, plus each coin's contract address per blockchain when include_platform is true. The full list has tens of thousands of entries. Use coingecko_list_coins to resolve coin IDs for other tools. Use coingecko_search to find a coin by name, and coingecko_list_coins_markets for prices and rankings.
Inputs
include_platformboolean- Set to true to add a platforms object mapping each asset platform ID to the coin's contract address. Default false.
statusstring- active (default) for listed coins, or inactive for delisted coins. inactive needs an Analyst plan or above, so it fails on Demo keys.one of
activeinactive
coingecko_list_coins_marketsList coins ranked by market cap (or another order) with live market data, optionally limited to given coins or a category.Read-onlyList Coins Markets
List coins ranked by market cap (or another order) with live market data, optionally limited to given coins or a category. Returns an array of coins with id, symbol, name, image, current_price, market_cap, market_cap_rank, total_volume, 24-hour high, low and change, supply figures, all-time high and low, and optional sparkline and multi-timeframe price changes. Use coingecko_list_coins_markets for top-N lists, screeners and category views. Use coingecko_get_simple_price for a quick price only, and coingecko_get_coin for one coin's full profile.
Inputs
vs_currencystringrequired- Currency to express prices and market data in, for example usd, eur or btc. Valid values come from coingecko_list_supported_vs_currencies.
categorystring- Category ID to limit results to, for example layer-1 or decentralized-finance-defi. Valid IDs come from coingecko_list_category_ids.
idsstring- CoinGecko coin IDs, comma-separated, to limit results to those coins (up to 250), for example bitcoin,ethereum. Priority when several filters are set: category, then ids, then names, then symbols.
include_rehypothecatedboolean- Set to true to include rehypothecated tokens in the ranking and add market_cap_rank_with_rehypothecated. Default false.
include_tokensstring- For lookups by symbols only: top (default) returns the top-ranked coin per symbol; all returns every coin sharing the symbol (up to 50 symbols). Send all only together with symbols.one of
topall localestring- Language for localized names. Default en.one of
arbgcsdadeelenesfifrhehihrhuiditjakoltnlnoplptroruskslsvthtrukvizhzh-tw namesstring- Coin names, comma-separated, for example Bitcoin,Ethereum.
orderstring- Sort order. Default market_cap_desc.one of
market_cap_ascmarket_cap_descvolume_ascvolume_descid_ascid_desc pageinteger- Page number to return, starting at 1. Omit for page 1.
per_pageinteger- Number of results per page, 1 to 250. Omit for CoinGecko's default of 100.
precisionstring- Number of decimal places for price values, 0 to 18, or full for no rounding. Omit for CoinGecko's default rounding.one of
full0123456789101112131415161718 price_change_percentagestring- Extra price-change timeframes to include, comma-separated, from 1h, 24h, 7d, 14d, 30d, 200d and 1y, for example 1h,7d.
sparklineboolean- Set to true to add 7-day sparkline price data for each coin. Default false.
symbolsstring- Ticker symbols, comma-separated, for example btc,eth. By default only the top-ranked coin per symbol is returned (see include_tokens).
coingecko_list_derivativesList tickers from derivatives exchanges: perpetuals and futures contracts.Read-onlyList Derivatives Tickers
List tickers from derivatives exchanges: perpetuals and futures contracts. Returns an array of contracts with market, symbol, index_id, price, 24-hour price change, contract type, index price, basis, spread, funding rate, open interest, 24-hour volume and expiry. Use coingecko_list_derivatives to compare funding rates and open interest across venues. Use coingecko_list_derivatives_exchanges for venue-level totals.
Inputs
This tool takes no inputs.
coingecko_list_derivatives_exchangesList derivatives exchanges with their open interest and volume, one page at a time.Read-onlyList Derivatives Exchanges
List derivatives exchanges with their open interest and volume, one page at a time. Returns an array of exchanges with id, name, open_interest_btc, trade_volume_24h_btc, number of perpetual and futures pairs, year established, country, URL and image. Use coingecko_list_derivatives_exchanges to rank derivatives venues. Use coingecko_get_derivatives_exchange for one venue's details and tickers.
Inputs
orderstring- Sort order. Default open_interest_btc_desc.one of
name_ascname_descopen_interest_btc_ascopen_interest_btc_desctrade_volume_24h_btc_asctrade_volume_24h_btc_desc pageinteger- Page number to return, starting at 1. Omit for page 1.
per_pageinteger- Number of results per page. Omit for CoinGecko's default.
coingecko_list_exchange_idsList every exchange's CoinGecko ID and name in one unpaginated response.Read-onlyList Exchange IDs
List every exchange's CoinGecko ID and name in one unpaginated response. Returns an array of {id, name}. Use coingecko_list_exchange_ids to resolve exchange IDs for other tools. Use coingecko_list_exchanges for volume, trust score and ranking.
Inputs
statusstring- active (default) for exchanges still listed, or inactive for delisted ones.one of
activeinactive
coingecko_list_exchangesList spot exchanges that have active trading volume on CoinGecko, with exchange data, one page at a time.Read-onlyList Exchanges
List spot exchanges that have active trading volume on CoinGecko, with exchange data, one page at a time. Returns an array of exchanges with id, name, year established, country, URL, image, trust score and rank, and 24-hour trading volume in BTC. Use coingecko_list_exchanges to rank or browse exchanges. Use coingecko_list_exchange_ids for every exchange ID in one call, and coingecko_get_exchange for one exchange's details.
Inputs
pageinteger- Page number to return, starting at 1. Omit for page 1.
per_pageinteger- Number of results per page, 1 to 250. Omit for CoinGecko's default of 100.
coingecko_list_nftsList the NFT collections CoinGecko tracks, 100 per page by default, optionally sorted by volume, floor price or market cap.Read-onlyList NFTs
List the NFT collections CoinGecko tracks, 100 per page by default, optionally sorted by volume, floor price or market cap. Returns an array of collections with id, contract_address, name, asset_platform_id and symbol. Use coingecko_list_nfts to find NFT collection IDs. Use coingecko_get_nft for a collection's floor price, volume and market data.
Inputs
orderstring- Sort order, for example market_cap_usd_desc or h24_volume_usd_desc. Omit for CoinGecko's default order.one of
h24_volume_usd_asch24_volume_usd_desch24_volume_native_asch24_volume_native_descfloor_price_native_ascfloor_price_native_descmarket_cap_native_ascmarket_cap_native_descmarket_cap_usd_ascmarket_cap_usd_desc pageinteger- Page number to return, starting at 1. Omit for page 1.
per_pageinteger- Number of results per page, 1 to 250. Omit for CoinGecko's default of 100.
coingecko_list_onchain_networksList the blockchain networks GeckoTerminal supports, one page at a time.Read-onlyList Onchain Networks
List the blockchain networks GeckoTerminal supports, one page at a time. Returns a JSON:API data array of networks with id (for example eth or solana), name and coingecko_asset_platform_id. Use coingecko_list_onchain_networks to find network values for coingecko_search_onchain_pools and coingecko_get_onchain_token_price. Use coingecko_list_asset_platforms for the IDs the non-onchain tools use.
Inputs
pageinteger- Page number to return, starting at 1. Omit for page 1.
coingecko_list_supported_vs_currenciesList every currency CoinGecko can quote prices in, including fiat currencies, crypto such as btc and eth, and commodities.Read-onlyList Supported VS Currencies
List every currency CoinGecko can quote prices in, including fiat currencies, crypto such as btc and eth, and commodities. Returns an array of lowercase currency codes, for example usd, eur, btc. Use this to find valid vs_currency and vs_currencies values for the price, market and chart tools.
Inputs
This tool takes no inputs.
coingecko_pingCheck that the CoinGecko API is reachable and the connection's API key is accepted.Read-onlyPing
Check that the CoinGecko API is reachable and the connection's API key is accepted. Returns a short status message (gecko_says). Use this to test the connection before other calls; it returns no market data.
Inputs
This tool takes no inputs.
coingecko_searchSearch CoinGecko for coins, exchanges, categories and NFT collections by name or symbol.Read-onlySearch
Search CoinGecko for coins, exchanges, categories and NFT collections by name or symbol. Returns separate coins, exchanges, categories and nfts arrays with IDs, names, symbols, market cap rank and thumbnails, best matches first. Use coingecko_search to turn a name like 'solana' into the coin ID other tools need. Use coingecko_list_coins for the complete ID list and coingecko_search_onchain_pools for DEX pools and on-chain tokens.
Inputs
querystringrequired- Text to search for: a coin, exchange, category or NFT name or symbol, for example solana or btc.
coingecko_search_onchain_poolsSearch GeckoTerminal DEX pools across all networks by pool address, token name, token symbol or token contract address, 20 pools per page.Read-onlySearch Onchain Pools
Search GeckoTerminal DEX pools across all networks by pool address, token name, token symbol or token contract address, 20 pools per page. Returns a JSON:API data array of pools with name, address, base and quote token prices in USD, FDV, market cap, reserve, price changes, transactions and volume, plus related tokens and DEX under included when include is set. Use coingecko_search_onchain_pools for on-chain and long-tail tokens. Use coingecko_search for coins and exchanges listed on CoinGecko.
Inputs
includestring- Related objects to add under included, comma-separated, from base_token, quote_token and dex.
networkstring- Only search pools on this GeckoTerminal network ID, for example eth, solana or base. Valid IDs come from coingecko_list_onchain_networks.
pageinteger- Page number, starting at 1. Demo keys can page up to 10.
querystring- Pool contract address, token name, token symbol or token contract address, for example weth.
No tools match.
