The CoinGecko Pro connector lets your AI agent act in each user's CoinGecko Pro account. Each user connects their own CoinGecko Pro API key once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 74 tools.
- Tools
- 74
- What they doRead · write · destructive
- 74 · 0 · 074 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 Pro connection
In AgentKit > Connections, create a CoinGecko Pro 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 = 'coingeckopro'const identifier = 'user_123'// Generate an authorization link for the userconst { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })console.log('Authorize CoinGecko Pro:', 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: 'coingeckopro_filter_onchain_pools',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 = "coingeckopro"identifier = "user_123"# Generate an authorization link for the userlink_response = actions.get_authorization_link(connection_name=connection_name,identifier=identifier,)print("Authorize CoinGecko Pro:", link_response.link)input("Press Enter after authorizing...")# Make your first callresult = actions.execute_tool(tool_input={},tool_name="coingeckopro_filter_onchain_pools",connection_name=connection_name,identifier=identifier,)print(result)Terminal window python quickstart.pyEach user opens the link once and enters their CoinGecko Pro credentials there. See Authorize a user for the full flow and statuses.
Tools
Pass the exact name toexecute_toolcoingeckopro_filter_onchain_poolsScreen GeckoTerminal DEX pools across networks by liquidity, FDV, volume, pool age, transaction counts, price change, token taxes, holders and safety checks, 20 pools per page.Read-onlyFilter Onchain Pools
Screen GeckoTerminal DEX pools across networks by liquidity, FDV, volume, pool age, transaction counts, price change, token taxes, holders and safety checks, 20 pools per page. Returns a JSON:API data array of pools with name, address, token prices in USD, FDV, market cap, reserve, price changes, transactions and volume, plus related tokens, DEX and network under included when include is set. Needs an Analyst plan or above (Analyst, Lite, Pro or Enterprise); Basic-plan keys are refused. Use coingeckopro_filter_onchain_pools to find pools that match numeric criteria. Use coingeckopro_search_onchain_pools to look up pools by name or address and coingeckopro_list_onchain_trending_search_pools for the most searched pools.
Inputs
buy_tax_percentage_maxnumber- Maximum token buy tax percentage, for example 5.
buy_tax_percentage_minnumber- Minimum token buy tax percentage, for example 0.
buys_durationstring- Window the buys filter counts over: 5m, 1h, 6h or 24h (default).one of
5m1h6h24h buys_maxinteger- Maximum number of buys in the buys_duration window, for example 50000.
buys_mininteger- Minimum number of buys in the buys_duration window, for example 50.
checksstring- Safety and quality checks pools must pass, comma-separated, from no_honeypot (not supported on Solana), good_gt_score (GT Score 75 or more), on_coingecko and has_social.
dexesstring- Only pools on these DEX IDs, comma-separated, for example uniswap_v3. Works only when networks names a single network.
fdv_usd_maxnumber- Maximum fully diluted valuation in USD, for example 500000000.
fdv_usd_minnumber- Minimum fully diluted valuation in USD, for example 1000000.
h24_volume_usd_maxnumber- Maximum 24-hour volume in USD, for example 50000000.
h24_volume_usd_minnumber- Minimum 24-hour volume in USD, for example 100000.
holder_count_maxinteger- Maximum number of token holders, for example 100000.
holder_count_mininteger- Minimum number of token holders, for example 500.
includestring- Related objects to add under included, comma-separated, from base_token, quote_token, dex and network.
include_unknown_honeypot_tokensboolean- With checks=no_honeypot, set to true to also keep tokens whose honeypot status is unknown. Default false.
networksstring- Only pools on these GeckoTerminal network IDs, comma-separated, for example eth,base. Valid IDs come from coingeckopro_list_onchain_networks.
pageinteger- Page number to return, starting at 1. Omit for page 1.
pool_created_hour_maxnumber- Maximum pool age in hours, for example 72.
pool_created_hour_minnumber- Minimum pool age in hours, for example 1.
price_change_percentage_durationstring- Window the price change filter uses: 5m, 1h, 6h or 24h (default).one of
5m1h6h24h price_change_percentage_maxnumber- Maximum price change percentage over price_change_percentage_duration, for example 200.
price_change_percentage_minnumber- Minimum price change percentage over price_change_percentage_duration, for example -10.
quote_token_addressesstring- Only pools whose quote token is one of these contract addresses, comma-separated, up to 50.
quote_token_presetstring- Only pools whose quote token is in a preset group: rwa_stock for tokenized stocks.one of
rwa_stock reserve_in_usd_maxnumber- Maximum pool liquidity reserve in USD, for example 10000000.
reserve_in_usd_minnumber- Minimum pool liquidity reserve in USD, for example 50000.
sell_tax_percentage_maxnumber- Maximum token sell tax percentage, for example 5.
sell_tax_percentage_minnumber- Minimum token sell tax percentage, for example 0.
sells_durationstring- Window the sells filter counts over: 5m, 1h, 6h or 24h (default).one of
5m1h6h24h sells_maxinteger- Maximum number of sells in the sells_duration window, for example 50000.
sells_mininteger- Minimum number of sells in the sells_duration window, for example 50.
sortstring- Sort order. Default h6_trending.one of
m5_trendingh1_trendingh6_trendingh24_trendingh24_tx_count_desch24_tx_count_asch24_volume_usd_desch24_volume_usd_ascm5_price_change_percentage_asch1_price_change_percentage_asch6_price_change_percentage_asch24_price_change_percentage_ascm5_price_change_percentage_desch1_price_change_percentage_desch6_price_change_percentage_desch24_price_change_percentage_descfdv_usd_ascfdv_usd_descreserve_in_usd_ascreserve_in_usd_descprice_ascprice_descpool_created_at_desc top_10_holders_percentage_maxnumber- Maximum share of supply held by the top 10 holders, in percent, for example 40.
top_10_holders_percentage_minnumber- Minimum share of supply held by the top 10 holders, in percent, for example 5.
tx_count_durationstring- Window the transactions filter counts over: 5m, 1h, 6h or 24h (default).one of
5m1h6h24h tx_count_maxinteger- Maximum number of transactions in the tx_count_duration window, for example 100000.
tx_count_mininteger- Minimum number of transactions in the tx_count_duration window, for example 100.
coingeckopro_get_api_usageGet the connected CoinGecko API key's plan, rate limit and monthly credit usage.Read-onlyGet API Usage
Get the connected CoinGecko API key's plan, rate limit and monthly credit usage. Returns plan, rate_limit_request_per_minute, monthly_call_credit, current_total_monthly_calls and current_remaining_monthly_calls for the account, plus the same limits and usage for this API key. Use coingeckopro_get_api_usage to check remaining credits or which plan the key is on before heavy or plan-gated calls. Use coingeckopro_ping only to test reachability.
Inputs
This tool takes no inputs.
coingeckopro_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), has_supply_breakdown and up to 100 exchange tickers. Use coingeckopro_get_coin for everything about one coin. Use coingeckopro_get_simple_price for price only, coingeckopro_get_coin_by_contract when you only have a contract address, coingeckopro_get_coin_tickers for more than 100 tickers, and coingeckopro_get_coin_supply_breakdown when has_supply_breakdown is true.
Inputs
coin_idstringrequired- CoinGecko coin API ID, for example bitcoin or ethereum. This is the id from coingeckopro_list_coins or coingeckopro_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.
coingeckopro_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 coingeckopro_get_coin: metadata, links, categories, contract addresses, market_data and up to 100 tickers. Use coingeckopro_get_coin_by_contract when you only have a contract address. Use coingeckopro_get_coin when you have the coin ID, and coingeckopro_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 coingeckopro_list_asset_platforms.
contract_addressstringrequired- The token's contract address on that platform, for example 0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2 (WETH on Ethereum).
coingeckopro_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. Basic-plan keys reach the past 2 years; Analyst and above reach the full history. Use coingeckopro_get_coin_history for a single past day. Use coingeckopro_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 coingeckopro_list_coins or coingeckopro_search, not the ticker symbol.
datestringrequired- The day to snapshot, in YYYY-MM-DD format, for example 2025-12-30. Basic-plan keys reach the past 2 years.
localizationboolean- Set to false to drop localized names in every language. Default true.
coingeckopro_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 (5m and 1m are Enterprise only). Basic-plan keys reach the past 2 years; Analyst and above reach the full history. Use coingeckopro_get_coin_market_chart for 'last N days'. Use coingeckopro_get_coin_market_chart_range for exact start and end dates, coingeckopro_get_coin_ohlc for candles, and coingeckopro_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 coingeckopro_list_coins or coingeckopro_search, not the ticker symbol.
daysstringrequired- How many days back from now to return: any whole number such as 1, 30 or 365, or max for the full history. Basic-plan keys reach the past 2 years.
vs_currencystringrequired- Currency to express prices and market data in, for example usd, eur or btc. Valid values come from coingeckopro_list_supported_vs_currencies.
intervalstring- Force the data interval: daily (one point per day at 00:00 UTC), hourly (past 100 days per request), 5m (past 10 days, Enterprise only) or 1m (past 1 day, Enterprise only, beta, data from 1 Jun 2026). Omit for automatic granularity.one of
1m5mhourlydaily 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
coingeckopro_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 (5m and 1m are Enterprise only). Basic-plan keys reach the past 2 years; Analyst and above reach the full history. Use coingeckopro_get_coin_market_chart_range for a fixed window. Use coingeckopro_get_coin_market_chart for 'last N days', coingeckopro_get_coin_ohlc_range for candles in a window, and coingeckopro_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 coingeckopro_list_coins or coingeckopro_search, not the ticker symbol.
fromstringrequired- Start of the range, as an ISO date YYYY-MM-DD or YYYY-MM-DDTHH:MM (recommended, for example 2026-01-01) or a UNIX timestamp in seconds.
tostringrequired- End of the range, as an ISO date YYYY-MM-DD or YYYY-MM-DDTHH:MM (recommended, for example 2026-02-01) or a UNIX timestamp in seconds.
vs_currencystringrequired- Currency to express prices and market data in, for example usd, eur or btc. Valid values come from coingeckopro_list_supported_vs_currencies.
intervalstring- Force the data interval: daily (one point per day at 00:00 UTC), hourly (any 100 days per request), 5m (any 10 days, Enterprise only) or 1m (any 1 day, Enterprise only, beta, data from 1 Jun 2026). Omit for automatic granularity.one of
1m5mhourlydaily 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
coingeckopro_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 3-30 days, 4 days beyond) unless interval is daily or hourly. Basic-plan keys reach the past 2 years; Analyst and above reach the full history. Use coingeckopro_get_coin_ohlc for candlestick charts over the last N days. Use coingeckopro_get_coin_ohlc_range for candles between two dates and coingeckopro_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 coingeckopro_list_coins or coingeckopro_search, not the ticker symbol.
daysstringrequired- How many days back from now to return: 1, 7, 14, 30, 90, 180, 365 or max.one of
17143090180365max vs_currencystringrequired- Currency to express prices and market data in, for example usd, eur or btc. Valid values come from coingeckopro_list_supported_vs_currencies.
intervalstring- Force the candle size: daily (for days 1, 7, 14, 30, 90 or 180) or hourly (for days 1, 7, 14, 30 or 90). Omit for automatic candle size.one of
dailyhourly 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
coingeckopro_get_coin_ohlc_rangeGet open, high, low and close price candles for a coin between two dates, by CoinGecko coin ID.Read-onlyGet Coin OHLC Range
Get open, high, low and close price candles for a coin between two dates, by CoinGecko coin ID. Returns an array of [UNIX ms close time, open, high, low, close]. daily candles cover up to 180 days per request and hourly candles up to 31 days; data starts 9 Feb 2018. Needs an Analyst plan or above (Analyst, Lite, Pro or Enterprise); Basic-plan keys are refused. Use coingeckopro_get_coin_ohlc_range for candles in a fixed window. Use coingeckopro_get_coin_ohlc for the last N days and coingeckopro_get_coin_market_chart_range for price, market cap and volume points.
Inputs
coin_idstringrequired- CoinGecko coin API ID, for example bitcoin or ethereum. This is the id from coingeckopro_list_coins or coingeckopro_search, not the ticker symbol.
fromstringrequired- Start of the range, as an ISO date YYYY-MM-DD or YYYY-MM-DDTHH:MM (recommended, for example 2026-01-01) or a UNIX timestamp in seconds.
intervalstringrequired- Candle size: daily (up to 180 days per request) or hourly (up to 31 days per request).one of
dailyhourly tostringrequired- End of the range, as an ISO date YYYY-MM-DD or YYYY-MM-DDTHH:MM (recommended, for example 2026-01-15) or a UNIX timestamp in seconds.
vs_currencystringrequired- Currency to express prices and market data in, for example usd, eur or btc. Valid values come from coingeckopro_list_supported_vs_currencies.
coingeckopro_get_coin_supply_breakdownGet how a coin's total supply splits into circulating and non-circulating supply, with the wallets that hold the non-circulating part.Read-onlyGet Coin Supply Breakdown
Get how a coin's total supply splits into circulating and non-circulating supply, with the wallets that hold the non-circulating part. Returns supply_data (total, circulating, outstanding and non-circulating supply, last updated) and a non_circulating_wallets array with address, label, balance, percentage of total supply and an anomaly flag (true means the balance update looked unreliable). Needs an Analyst plan or above (Analyst, Lite, Pro or Enterprise); Basic-plan keys are refused. Use coingeckopro_get_coin_supply_breakdown when coingeckopro_get_coin shows has_supply_breakdown true. Use coingeckopro_get_coin_supply_chart for supply over time.
Inputs
coin_idstringrequired- CoinGecko coin API ID, for example uniswap. Check has_supply_breakdown in coingeckopro_get_coin first: not every coin has a breakdown.
coingeckopro_get_coin_supply_chartGet a coin's historical circulating supply or total supply for the last N days, by CoinGecko coin ID.Read-onlyGet Coin Supply Chart
Get a coin's historical circulating supply or total supply for the last N days, by CoinGecko coin ID. Returns a circulating_supply or total_supply array of [UNIX ms, supply] points. Granularity is automatic: 5-minutely for 1 day, hourly for 2-90 days, daily beyond. Circulating supply starts 22 Jun 2019; total supply has full coverage from 27 Jul 2023. Enterprise plan only: other plans are refused. Use coingeckopro_get_coin_supply_chart for 'last N days'. Use coingeckopro_get_coin_supply_chart_range for exact dates and coingeckopro_get_coin_supply_breakdown for today's locked and unlocked wallets.
Inputs
coin_idstringrequired- CoinGecko coin API ID, for example bitcoin or ethereum. This is the id from coingeckopro_list_coins or coingeckopro_search, not the ticker symbol.
daysstringrequired- How many days back from now to return: any whole number such as 1, 30 or 365, or max for the full history.
supply_typestringrequired- Which supply series to return: circulating_supply or total_supply.one of
circulating_supplytotal_supply intervalstring- Force the data interval: daily for either supply type; 5m or hourly for circulating_supply only. Omit for automatic granularity.one of
5mhourlydaily
coingeckopro_get_coin_supply_chart_rangeGet a coin's historical circulating supply or total supply between two dates, by CoinGecko coin ID.Read-onlyGet Coin Supply Chart Range
Get a coin's historical circulating supply or total supply between two dates, by CoinGecko coin ID. Returns a circulating_supply or total_supply array of [UNIX ms, supply] points. Circulating supply uses automatic granularity (5-minutely within the last day, hourly up to 90 days, daily beyond); total supply is daily at 00:00 UTC. Enterprise plan only: other plans are refused. Use coingeckopro_get_coin_supply_chart_range for a fixed window. Use coingeckopro_get_coin_supply_chart for 'last N days'.
Inputs
coin_idstringrequired- CoinGecko coin API ID, for example bitcoin or ethereum. This is the id from coingeckopro_list_coins or coingeckopro_search, not the ticker symbol.
fromstringrequired- Start of the range, as an ISO date YYYY-MM-DD or YYYY-MM-DDTHH:MM (recommended, for example 2025-01-01) or a UNIX timestamp in seconds.
supply_typestringrequired- Which supply series to return: circulating_supply or total_supply.one of
circulating_supplytotal_supply tostringrequired- End of the range, as an ISO date YYYY-MM-DD or YYYY-MM-DDTHH:MM (recommended, for example 2025-12-31) or a UNIX timestamp in seconds.
coingeckopro_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 coingeckopro_get_coin_tickers for one coin across exchanges. Use coingeckopro_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 coingeckopro_list_coins or coingeckopro_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.
coingeckopro_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 coingeckopro_get_coin_market_chart. Basic-plan keys reach the past 2 years; Analyst and above reach the full history. Use coingeckopro_get_contract_market_chart when you only have a contract address. Use coingeckopro_get_coin_market_chart when you have the coin ID, and coingeckopro_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 coingeckopro_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, or max for the full history. Basic-plan keys reach the past 2 years.
vs_currencystringrequired- Currency to express prices and market data in, for example usd, eur or btc. Valid values come from coingeckopro_list_supported_vs_currencies.
intervalstring- Force the data interval: daily (one point per day at 00:00 UTC), hourly (past 100 days per request), 5m (past 10 days, Enterprise only) or 1m (past 1 day, Enterprise only, beta, data from 1 Jun 2026). CoinGecko's reference lists interval overrides on this contract-address endpoint as an Enterprise-plan feature, so hourly may also be refused on other plans. Omit for automatic granularity.one of
1m5mhourlydaily 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
coingeckopro_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 unless interval is set. Basic-plan keys reach the past 2 years; Analyst and above reach the full history. Use coingeckopro_get_contract_market_chart_range for a fixed window by contract address. Use coingeckopro_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 coingeckopro_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 an ISO date YYYY-MM-DD or YYYY-MM-DDTHH:MM (recommended, for example 2026-01-01) or a UNIX timestamp in seconds.
tostringrequired- End of the range, as an ISO date YYYY-MM-DD or YYYY-MM-DDTHH:MM (recommended, for example 2026-02-01) or a UNIX timestamp in seconds.
vs_currencystringrequired- Currency to express prices and market data in, for example usd, eur or btc. Valid values come from coingeckopro_list_supported_vs_currencies.
intervalstring- Force the data interval: daily (one point per day at 00:00 UTC), hourly (any 100 days per request), 5m (any 10 days, Enterprise only) or 1m (any 1 day, Enterprise only, beta, data from 1 Jun 2026). CoinGecko's reference lists interval overrides on this contract-address endpoint as an Enterprise-plan feature, so hourly may also be refused on other plans. Omit for automatic granularity.one of
1m5mhourlydaily 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
coingeckopro_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 coingeckopro_get_derivatives_exchange for derivatives venues such as binance_futures. Use coingeckopro_get_exchange for spot exchanges.
Inputs
exchange_idstringrequired- CoinGecko derivatives exchange ID, for example binance_futures or bybit. Find IDs with coingeckopro_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
coingeckopro_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 coingeckopro_get_exchange for an exchange profile. Use coingeckopro_get_exchange_tickers for all of its trading pairs, and coingeckopro_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 coingeckopro_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
coingeckopro_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 coingeckopro_get_exchange_rates to convert BTC-denominated figures, such as exchange volumes, into other currencies.
Inputs
This tool takes no inputs.
coingeckopro_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 coingeckopro_get_exchange_tickers to see what trades on an exchange. Use coingeckopro_get_coin_tickers to see where one coin trades across exchanges.
Inputs
exchange_idstringrequired- CoinGecko exchange ID, for example binance. Valid IDs come from coingeckopro_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.
coingeckopro_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: 10-minutely for 1 day, hourly for 7 and 14 days, daily for 30 days and above. Use coingeckopro_get_exchange_volume_chart for 'last N days'. Use coingeckopro_get_exchange_volume_chart_range for exact dates and coingeckopro_get_exchange for the 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.
coingeckopro_get_exchange_volume_chart_rangeGet an exchange's daily trading volume, in BTC, between two dates up to 31 days apart.Read-onlyGet Exchange Volume Chart Range
Get an exchange's daily trading volume, in BTC, between two dates up to 31 days apart. Returns an array of [UNIX ms, volume in BTC] points, one per day. Works for derivatives exchanges too. Needs an Analyst plan or above (Analyst, Lite, Pro or Enterprise); Basic-plan keys are refused. Use coingeckopro_get_exchange_volume_chart_range for exact dates. Use coingeckopro_get_exchange_volume_chart for 'last N days' and coingeckopro_get_exchange_rates to convert BTC volumes.
Inputs
exchange_idstringrequired- CoinGecko exchange ID or derivatives exchange ID, for example binance or binance_futures. Valid IDs come from coingeckopro_list_exchange_ids.
fromintegerrequired- Start of the range as a UNIX timestamp in seconds, for example 1767225600 (2026-01-01). The range must be 31 days or less.
tointegerrequired- End of the range as a UNIX timestamp in seconds, for example 1769817600 (2026-01-31).
coingeckopro_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 coingeckopro_get_global for current whole-market figures. Use coingeckopro_get_global_market_cap_chart for their history, coingeckopro_get_global_defi for DeFi-only figures and coingeckopro_list_categories for per-sector figures.
Inputs
This tool takes no inputs.
coingeckopro_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 coingeckopro_get_global_defi for DeFi-only figures. Use coingeckopro_get_global for the whole crypto market.
Inputs
This tool takes no inputs.
coingeckopro_get_global_market_cap_chartGet the historical total crypto market cap and 24-hour volume for the last N days.Read-onlyGet Global Market Cap Chart
Get the historical total crypto market cap and 24-hour volume for the last N days. Returns market_cap_chart with market_cap and volume arrays of [UNIX ms, value] points: hourly for 1 day, daily for 2 days and above. Needs an Analyst plan or above (Analyst, Lite, Pro or Enterprise); Basic-plan keys are refused. Use coingeckopro_get_global_market_cap_chart for whole-market history. Use coingeckopro_get_global for current figures and dominance.
Inputs
daysstringrequired- How many days back from now to return: 1, 7, 14, 30, 90, 180, 365 or max.one of
17143090180365max vs_currencystring- Currency to express prices and market data in, for example usd, eur or btc. Valid values come from coingeckopro_list_supported_vs_currencies. Default usd.
coingeckopro_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 coingeckopro_get_nft when you have the collection ID. Use coingeckopro_get_nft_by_contract when you only have the contract address, coingeckopro_get_nft_market_chart for history, coingeckopro_get_nft_tickers for per-marketplace prices, and coingeckopro_list_nfts to find IDs.
Inputs
nft_idstringrequired- CoinGecko NFT collection ID, for example pudgy-penguins. Valid IDs come from coingeckopro_list_nfts.
coingeckopro_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 coingeckopro_get_nft: floor price, market cap, 24-hour volume and their changes, owners, supply and links. Use coingeckopro_get_nft_by_contract when you only have the contract address. Use coingeckopro_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 coingeckopro_list_asset_platforms. Use coingeckopro_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).
coingeckopro_get_nft_market_chartGet an NFT collection's historical floor price, market cap and 24-hour volume for the last N days, by CoinGecko NFT ID.Read-onlyGet NFT Market Chart
Get an NFT collection's historical floor price, market cap and 24-hour volume for the last N days, by CoinGecko NFT ID. Returns arrays floor_price_usd, floor_price_native, h24_volume_usd, h24_volume_native, market_cap_usd and market_cap_native of [UNIX ms, value] points: 5-minutely for 1-14 days, daily beyond. Needs an Analyst plan or above (Analyst, Lite, Pro or Enterprise); Basic-plan keys are refused. Use coingeckopro_get_nft_market_chart when you have the collection ID. Use coingeckopro_get_nft_market_chart_by_contract when you only have the contract address, and coingeckopro_get_nft for current figures.
Inputs
daysstringrequired- How many days back from now to return: any whole number such as 1, 30 or 365, or max.
nft_idstringrequired- CoinGecko NFT collection ID, for example pudgy-penguins. Valid IDs come from coingeckopro_list_nfts.
coingeckopro_get_nft_market_chart_by_contractGet an NFT collection's historical floor price, market cap and 24-hour volume for the last N days, by blockchain and contract address.Read-onlyGet NFT Market Chart by Contract
Get an NFT collection's historical floor price, market cap and 24-hour volume for the last N days, by blockchain and contract address. Returns arrays floor_price_usd, floor_price_native, h24_volume_usd, h24_volume_native, market_cap_usd and market_cap_native of [UNIX ms, value] points: 5-minutely for 1-14 days, daily beyond. Solana NFTs and Art Blocks are not supported here. Needs an Analyst plan or above (Analyst, Lite, Pro or Enterprise); Basic-plan keys are refused. Use coingeckopro_get_nft_market_chart_by_contract when you only have the contract address. Use coingeckopro_get_nft_market_chart when you have the CoinGecko NFT ID (required for Solana and Art Blocks).
Inputs
asset_platform_idstringrequired- CoinGecko asset platform (blockchain) ID, for example ethereum, solana or binance-smart-chain. Valid IDs come from coingeckopro_list_asset_platforms. Use coingeckopro_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).
daysstringrequired- How many days back from now to return: any whole number such as 1, 30 or 365, or max.
coingeckopro_get_nft_tickersGet an NFT collection's latest floor price and 24-hour volume on each NFT marketplace, such as OpenSea and Blur.Read-onlyGet NFT Tickers
Get an NFT collection's latest floor price and 24-hour volume on each NFT marketplace, such as OpenSea and Blur. Returns a tickers array with marketplace ID and name, floor price and 24-hour volume in the native currency, native currency symbol, collection URL and update time. Needs an Analyst plan or above (Analyst, Lite, Pro or Enterprise); Basic-plan keys are refused. Use coingeckopro_get_nft_tickers to compare marketplaces. Use coingeckopro_get_nft for the collection's aggregated figures.
Inputs
nft_idstringrequired- CoinGecko NFT collection ID, for example pudgy-penguins. Valid IDs come from coingeckopro_list_nfts.
coingeckopro_get_onchain_holders_chartGet the historical number of holders of a token on one network (beta).Read-onlyGet Onchain Holders Chart
Get the historical number of holders of a token on one network (beta). Returns a JSON:API object whose token_holders_list holds [timestamp, holder count] entries, plus token metadata under meta: every data point for 7 days, daily for 30 days and weekly for max. Needs an Analyst plan or above (Analyst, Lite, Pro or Enterprise); Basic-plan keys are refused. Use coingeckopro_get_onchain_holders_chart to track adoption over time. Use coingeckopro_get_onchain_top_holders for who holds the most today.
Inputs
networkstringrequired- GeckoTerminal network ID, for example eth, solana or base. Valid IDs come from coingeckopro_list_onchain_networks. Supported here: solana, eth, base, bsc, polygon_pos, arbitrum, optimism, avax, stable, robinhood, linea, arc, ton, sui-network, ronin and bittensor.
token_addressstringrequired- The token's contract address on that network, for example Dfh5DzRgSvvCFDoYc2ciTkMrbDfRKybA4SoFbPmApump.
daysstring- Period to return: 7 (default), 30 or max.one of
730max
coingeckopro_get_onchain_pool_liquidity_eventsList the add-liquidity and remove-liquidity events in one DEX pool, newest first, paged with a cursor.Read-onlyGet Onchain Pool Liquidity Events
List the add-liquidity and remove-liquidity events in one DEX pool, newest first, paged with a cursor. Returns a JSON:API data array of events with kind (add or remove), block number and time, transaction hash, sender address, base and quote token addresses, amounts (always positive) and USD prices, and combined volume in USD, plus meta.next_cursor. Only Solana PumpSwap and Meteora DAMM v2 pools are supported (other pools return 400); history starts May 2026. Needs an Analyst plan or above (Analyst, Lite, Pro or Enterprise); Basic-plan keys are refused. Use coingeckopro_get_onchain_pool_liquidity_events to watch liquidity moves. Use coingeckopro_get_onchain_pool_trades_range for swaps.
Inputs
networkstringrequired- GeckoTerminal network ID, for example eth, solana or base. Valid IDs come from coingeckopro_list_onchain_networks. Only solana is supported here.
pool_addressstringrequired- The pool's address, for example G9YxfMcZQiW7EmsU1Asxuomcm5iQrBDKpbozuTM2iwne (a PumpSwap or Meteora DAMM v2 pool on Solana).
cursorstring- Cursor for the next page: pass meta.next_cursor from the previous response back unchanged. Omit for the first page; next_cursor is null on the last page.
kindstring- Only add or only remove events. Omit for both.one of
addremove per_pageinteger- Number of events per page, 1 to 50. Default 20.
volume_in_usd_greater_thannumber- Only events worth more than this many US dollars (a positive number), for example 500.
coingeckopro_get_onchain_pool_trades_rangeList the trades in one DEX pool between two dates up to 30 days apart, oldest pages first via a cursor.Read-onlyGet Onchain Pool Trades Range
List the trades in one DEX pool between two dates up to 30 days apart, oldest pages first via a cursor. Returns a JSON:API data array of trades with pool address and DEX, block number and time, transaction hash, sender address, kind (buy or sell), from and to token addresses and amounts, prices in USD, volume in USD and an is_anomalous flag, plus meta.next_cursor for the next page. Needs an Analyst plan or above (Analyst, Lite, Pro or Enterprise); Basic-plan keys are refused. Use coingeckopro_get_onchain_pool_trades_range for a pool's trades in an exact window. Use coingeckopro_get_onchain_token_trades_range for a token across all its pools and coingeckopro_get_onchain_pool_liquidity_events for liquidity adds and removes.
Inputs
fromstringrequired- Start of the range, as an ISO date YYYY-MM-DD or YYYY-MM-DDTHH:MM (recommended, for example 2026-09-01) or a UNIX timestamp in seconds. The window cannot exceed 30 days or end in the future.
networkstringrequired- GeckoTerminal network ID, for example eth, solana or base. Valid IDs come from coingeckopro_list_onchain_networks.
pool_addressstringrequired- The pool's contract address on that network, for example 0x06da0fd433c1a5d7a4faa01111c044910a184553. Find pools with coingeckopro_search_onchain_pools.
tostringrequired- End of the range, as an ISO date YYYY-MM-DD or YYYY-MM-DDTHH:MM (recommended, for example 2026-09-08) or a UNIX timestamp in seconds.
cursorstring- Cursor for the next page: pass meta.next_cursor from the previous response back unchanged. Omit for the first page; next_cursor is null on the last page.
include_anomalousboolean- Set to true to include trades flagged as anomalous. Default false.
per_pageinteger- Number of trades per page, 1 to 300. Default 100.
tokenstring- Which side to report trades for: base (default), quote, or a token address in the pool. Use quote to invert prices.
trade_volume_in_usd_greater_thannumber- Only trades worth more than this many US dollars, for example 1000. Default 0.
coingeckopro_get_onchain_token_ohlcvGet open, high, low, close and volume candles for a token on one network, built from its most liquid DEX pool.Read-onlyGet Onchain Token OHLCV
Get open, high, low, close and volume candles for a token on one network, built from its most liquid DEX pool. Returns a JSON:API object whose ohlcv_list holds [UNIX seconds, open, high, low, close, volume] candles, newest first (100 by default, up to 1000), plus base and quote token metadata. Data reaches back to Sep 2021, at most 6 months per call; page back with before_timestamp. Needs an Analyst plan or above (Analyst, Lite, Pro or Enterprise); Basic-plan keys are refused. Use coingeckopro_get_onchain_token_ohlcv for DEX candles of any token. Use coingeckopro_get_coin_ohlc for CoinGecko-listed coins aggregated across exchanges.
Inputs
networkstringrequired- GeckoTerminal network ID, for example eth, solana or base. Valid IDs come from coingeckopro_list_onchain_networks.
timeframestringrequired- Candle unit: day, hour, minute or second. Combine with aggregate for multi-unit candles.one of
dayhourminutesecond token_addressstringrequired- The token's contract address on that network, for example So11111111111111111111111111111111111111112.
aggregatestring- How many timeframe units per candle: day takes 1; hour takes 1, 4 or 12; minute takes 1, 5 or 15; second takes 1, 15 or 30. Default 1.
before_timestampinteger- Only return candles before this UNIX time in seconds, for example 1767225600, to page back through history.
currencystring- Price candles in usd (default) or in the quote token.one of
usdtoken include_empty_intervalsboolean- Set to true to fill intervals with no trades (OHLC repeats the previous close, volume 0). Default false.
include_inactive_sourceboolean- Set to true to use inactive pools' most recent swaps when the token has no active pool. Default false.
limitinteger- Number of candles to return, up to 1000. Default 100.
coingeckopro_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 coingeckopro_get_onchain_token_price for DEX-traded tokens on one network, including ones CoinGecko does not list. Use coingeckopro_get_onchain_token_price_multi for several networks at once (Enterprise) and coingeckopro_get_token_price for CoinGecko's aggregated price in any currency.
Inputs
addressesstringrequired- Token contract addresses on that network, comma-separated: up to 30, or up to 100 on Analyst plans and above.
networkstringrequired- GeckoTerminal network ID, for example eth, solana or base. Valid IDs come from coingeckopro_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.
coingeckopro_get_onchain_token_price_multiGet the current USD price of up to 50 tokens on any mix of networks in one call, from GeckoTerminal DEX pools.Read-onlyGet Onchain Token Price Across Networks
Get the current USD price of up to 50 tokens on any mix of networks in one call, from GeckoTerminal DEX pools. Returns a JSON:API object keyed by the same network_id:token_address pairs, each with a USD price, plus market cap, 24-hour volume, 24-hour price change and total reserve when asked. Enterprise plan only: other plans are refused. Use coingeckopro_get_onchain_token_price_multi for prices across networks. Use coingeckopro_get_onchain_token_price for one network (any paid plan) and coingeckopro_get_onchain_tokens_multi for full token data.
Inputs
tokensstringrequired- Network ID and token contract address pairs as network_id:token_address, comma-separated, up to 50 pairs, for example eth:0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2,solana:6NwarBvDkXhByqVp2Qkq5i9XbtA2B3Bwe8SWGu9vpump. Networks can be mixed. An unknown network ID fails the whole request with 400; an unknown token address is left out.
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.
coingeckopro_get_onchain_token_tradesList recent trades of a token across all its DEX pools on one network, over the last 1, 7 or 30 days, paged with a cursor.Read-onlyGet Onchain Token Trades
List recent trades of a token across all its DEX pools on one network, over the last 1, 7 or 30 days, paged with a cursor. Returns a JSON:API data array of trades with pool address and DEX, block number and time, transaction hash, sender address, kind (buy or sell), from and to token addresses and amounts, prices in USD, volume in USD and an is_anomalous flag, plus meta.next_cursor for the next page. Needs an Analyst plan or above (Analyst, Lite, Pro or Enterprise); Basic-plan keys are refused. Use coingeckopro_get_onchain_token_trades for a token's recent trades. Use coingeckopro_get_onchain_token_trades_range for an exact window and coingeckopro_get_onchain_wallet_trades for one wallet's trades.
Inputs
networkstringrequired- GeckoTerminal network ID, for example eth, solana or base. Valid IDs come from coingeckopro_list_onchain_networks.
token_addressstringrequired- The token's contract address on that network, for example 0xdac17f958d2ee523a2206206994597c13d831ec7.
cursorstring- Cursor for the next page: pass meta.next_cursor from the previous response back unchanged. Omit for the first page; next_cursor is null on the last page.
include_anomalousboolean- Set to true to include trades flagged as anomalous. Default false.
per_pageinteger- Number of trades per page, 1 to 300. Default 300.
trade_volume_in_usd_greater_thannumber- Only trades worth more than this many US dollars, for example 1000. Default 0.
trading_periodstring- How far back to look: 1d (default), 7d or 30d.one of
1d7d30d
coingeckopro_get_onchain_token_trades_rangeList the trades of a token across all its DEX pools on one network between two dates up to 30 days apart, paged with a cursor.Read-onlyGet Onchain Token Trades Range
List the trades of a token across all its DEX pools on one network between two dates up to 30 days apart, paged with a cursor. Returns a JSON:API data array of trades with pool address and DEX, block number and time, transaction hash, sender address, kind (buy or sell), from and to token addresses and amounts, prices in USD, volume in USD and an is_anomalous flag, plus meta.next_cursor for the next page. Needs an Analyst plan or above (Analyst, Lite, Pro or Enterprise); Basic-plan keys are refused. Use coingeckopro_get_onchain_token_trades_range for an exact window. Use coingeckopro_get_onchain_token_trades for the last 1, 7 or 30 days and coingeckopro_get_onchain_pool_trades_range for one pool.
Inputs
fromstringrequired- Start of the range, as an ISO date YYYY-MM-DD or YYYY-MM-DDTHH:MM (recommended, for example 2026-09-01) or a UNIX timestamp in seconds. The window cannot exceed 30 days or end in the future.
networkstringrequired- GeckoTerminal network ID, for example eth, solana or base. Valid IDs come from coingeckopro_list_onchain_networks.
tostringrequired- End of the range, as an ISO date YYYY-MM-DD or YYYY-MM-DDTHH:MM (recommended, for example 2026-09-08) or a UNIX timestamp in seconds.
token_addressstringrequired- The token's contract address on that network, for example 0xdac17f958d2ee523a2206206994597c13d831ec7.
cursorstring- Cursor for the next page: pass meta.next_cursor from the previous response back unchanged. Omit for the first page; next_cursor is null on the last page.
include_anomalousboolean- Set to true to include trades flagged as anomalous. Default false.
per_pageinteger- Number of trades per page, 1 to 300. Default 100.
trade_volume_in_usd_greater_thannumber- Only trades worth more than this many US dollars, for example 1000. Default 0.
coingeckopro_get_onchain_tokens_multiGet GeckoTerminal data for up to 50 tokens on any mix of networks in one call, by network and contract address.Read-onlyGet Onchain Tokens Across Networks
Get GeckoTerminal data for up to 50 tokens on any mix of networks in one call, by network and contract address. Returns a JSON:API data array of tokens with network, name, symbol, decimals, price in USD, FDV, market cap, total reserve and 24-hour volume, plus each token's most liquid pools under included when include=top_pools. Enterprise plan only: other plans are refused. Use coingeckopro_get_onchain_tokens_multi for token data across networks. Use coingeckopro_get_onchain_token_price_multi for prices only and coingeckopro_get_onchain_token_price for one network.
Inputs
tokensstringrequired- Network ID and token contract address pairs as network_id:token_address, comma-separated, up to 50 pairs, for example eth:0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2,solana:6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN. Networks can be mixed. An unknown network ID fails the whole request with 400; an unknown token address is left out.
includestring- Set to top_pools to add each token's top pools under included.one of
top_pools include_compositionboolean- With include=top_pools, set to true to add each pool's base and quote token balances and liquidity. Default false.
include_inactive_sourceboolean- Set to true to fall back to the most recent swap in inactive pools when a token has no active pool. Default false.
coingeckopro_get_onchain_top_holdersGet the largest holders of a token on one network (beta).Read-onlyGet Onchain Top Holders
Get the largest holders of a token on one network (beta). Returns a JSON:API object with last_updated_at and a holders list: rank, wallet address, label, amount held, percentage of supply, value in USD and explorer URL, plus average buy price, buy and sell counts and PnL when include_pnl_details is true. Needs an Analyst plan or above (Analyst, Lite, Pro or Enterprise); Basic-plan keys are refused. Use coingeckopro_get_onchain_top_holders for concentration of ownership. Use coingeckopro_get_onchain_holders_chart for the holder count over time and coingeckopro_get_onchain_top_traders for the most profitable traders.
Inputs
networkstringrequired- GeckoTerminal network ID, for example eth, solana or base. Valid IDs come from coingeckopro_list_onchain_networks. Supported here: solana, eth, base, bsc, polygon_pos, arbitrum, optimism, avax, stable, robinhood, linea, arc, ton, sui-network, ronin and bittensor.
token_addressstringrequired- The token's contract address on that network, for example Dfh5DzRgSvvCFDoYc2ciTkMrbDfRKybA4SoFbPmApump.
holdersstring- Number of top holders to return: a whole number up to 50 (40 on Solana), or max. Default 10.
include_pnl_detailsboolean- Set to true to add each holder's average buy price, realized and unrealized PnL. Default false.
coingeckopro_get_onchain_top_tradersGet the top traders of a token on one network, ranked by realized PnL by default (beta).Read-onlyGet Onchain Top Traders
Get the top traders of a token on one network, ranked by realized PnL by default (beta). Returns a JSON:API object with a traders list: wallet address, name, label and type, realized and unrealized PnL in USD, token balance, average buy and sell prices, buy and sell counts, amounts bought and sold in tokens and USD, and an explorer URL. Only tokens created after 1 Sep 2023 are covered; stablecoins and wrapped native tokens are not. Needs an Analyst plan or above (Analyst, Lite, Pro or Enterprise); Basic-plan keys are refused. Use coingeckopro_get_onchain_top_traders to see who profits from a token. Use coingeckopro_get_onchain_top_holders for the largest balances and coingeckopro_get_onchain_wallet_pnl for one wallet across tokens.
Inputs
networkstringrequired- GeckoTerminal network ID, for example eth, solana or base. Valid IDs come from coingeckopro_list_onchain_networks.
token_addressstringrequired- The token's contract address on that network, for example Dfh5DzRgSvvCFDoYc2ciTkMrbDfRKybA4SoFbPmApump.
include_address_labelboolean- Set to true to add known labels for trader addresses (for example exchanges). Default false.
sortstring- Rank traders by realized_pnl_usd_desc (default), unrealized_pnl_usd_desc, total_buy_usd_desc, total_sell_usd_desc or token_balance_desc.one of
realized_pnl_usd_descunrealized_pnl_usd_desctotal_buy_usd_desctotal_sell_usd_desctoken_balance_desc tradersstring- Number of top traders to return: a whole number up to 50, or max. Default 10.
coingeckopro_get_onchain_wallet_balancesGet a wallet's token balances on one or more networks of the same VM family, with USD values, largest first.Read-onlyGet Onchain Wallet Balances
Get a wallet's token balances on one or more networks of the same VM family, with USD values, largest first. Returns a JSON:API object with total_value_usd, total_holdings, per-network totals and a balances list: network, token address, name, symbol, token_type (native, erc20 or spl), balance (and balance_raw with decimals), price_usd, value_usd and 24-hour price change. Totals cover only the requested networks and filters. Needs an Analyst plan or above (Analyst, Lite, Pro or Enterprise); Basic-plan keys are refused. Use coingeckopro_get_onchain_wallet_balances for a portfolio snapshot. Use coingeckopro_get_onchain_wallet_pnl for profit and loss and coingeckopro_get_onchain_wallet_transfers for movements.
Inputs
networksstringrequired- Networks to read, comma-separated, all from the same VM family (mixing families returns 400), for example eth,base. Supported: eth, base, bsc, polygon_pos, arbitrum, optimism, avax, stable, robinhood, linea and arc.
wallet_addressstringrequired- The wallet address, for example 0x9642b23ed1e01df1092b92641051881a322f5d4e.
pageinteger- Page number to return, starting at 1. Omit for page 1.
per_pageinteger- Number of holdings per page, 1 to 100. Default 50.
reserve_in_usd_minnumber- Only tokens whose pools hold at least this much liquidity in USD, for example 10000, to skip spam tokens.
sortstring- value_usd_desc (default) or value_usd_asc.one of
value_usd_descvalue_usd_asc token_typestring- Only native tokens or only non_native tokens (ERC-20, SPL). Omit for both.one of
nativenon_native value_usd_minnumber- Only holdings worth at least this many US dollars, for example 10.
coingeckopro_get_onchain_wallet_pnlGet a wallet's profit and loss per token on one or more networks of the same VM family.Read-onlyGet Onchain Wallet PnL
Get a wallet's profit and loss per token on one or more networks of the same VM family. Returns a JSON:API object with total realized and unrealized PnL in USD, per-network totals, and token_stats per token: network, address, name, symbol, realized and unrealized PnL in USD, buy and sell counts, amounts bought and sold in tokens and USD, and average buy and sell prices. Needs an Analyst plan or above (Analyst, Lite, Pro or Enterprise); Basic-plan keys are refused. Use coingeckopro_get_onchain_wallet_pnl to evaluate a wallet's trading results. Use coingeckopro_get_onchain_wallet_trades for the trades themselves and coingeckopro_get_onchain_top_traders for the best traders of one token.
Inputs
networksstringrequired- Networks to read, comma-separated, all from the same VM family (mixing families returns 400), for example eth,base.
wallet_addressstringrequired- The wallet address, for example 0x4b3f1048c55faa0c0873e249e541139360501f2a.
pageinteger- Page number to return, starting at 1. Omit for page 1.
per_pageinteger- Number of tokens per page, 1 to 300. Default 100.
sortstring- Rank tokens by realized_pnl_usd_desc (default), unrealized_pnl_usd_desc, total_buy_usd_desc or total_sell_usd_desc.one of
realized_pnl_usd_descunrealized_pnl_usd_desctotal_buy_usd_desctotal_sell_usd_desc
coingeckopro_get_onchain_wallet_tradesList a wallet's DEX trades on one network, newest first, paged with a cursor.Read-onlyGet Onchain Wallet Trades
List a wallet's DEX trades on one network, newest first, paged with a cursor. Returns a JSON:API data array of trades with pool address and DEX, block number and time, transaction hash, sender address, kind (buy or sell), from and to token addresses and amounts, prices in USD, volume in USD and an is_anomalous flag, plus meta.next_cursor for the next page. Needs an Analyst plan or above (Analyst, Lite, Pro or Enterprise); Basic-plan keys are refused. Use coingeckopro_get_onchain_wallet_trades for one wallet's swaps. Use coingeckopro_get_onchain_wallet_pnl for its profit and loss and coingeckopro_get_onchain_token_trades for all trades of a token.
Inputs
networkstringrequired- GeckoTerminal network ID, for example eth, solana or base. Valid IDs come from coingeckopro_list_onchain_networks.
wallet_addressstringrequired- The wallet address, for example 0x7942262a7a5637e6eb0eec9b91b55ec232141f87.
cursorstring- Cursor for the next page: pass meta.next_cursor from the previous response back unchanged. Omit for the first page; next_cursor is null on the last page.
fromstring- Start of the range, as an ISO date YYYY-MM-DD or YYYY-MM-DDTHH:MM (recommended) or UNIX seconds, for example 2026-10-01. Give from and to together (up to 30 days apart); omit both for the last 7 days.
include_anomalousboolean- Set to true to include trades flagged as anomalous. Default false.
per_pageinteger- Number of trades per page, 1 to 300. Default 100.
tostring- End of the range, as an ISO date YYYY-MM-DD or YYYY-MM-DDTHH:MM (recommended) or UNIX seconds, for example 2026-10-08. Give from and to together (up to 30 days apart); omit both for the last 7 days.
tokenstring- Only trades involving this token contract address, for example 0xdac17f958d2ee523a2206206994597c13d831ec7.
coingeckopro_get_onchain_wallet_transfersList a wallet's token transfers in and out on one network, newest first, paged with a cursor.Read-onlyGet Onchain Wallet Transfers
List a wallet's token transfers in and out on one network, newest first, paged with a cursor. Native-coin transfers such as ETH are not included yet. Returns a JSON:API data array of transfers with block number and time, transaction hash, direction, token address, name, symbol and decimals, amount (and amount_raw), from_address and to_address, plus meta.next_cursor. Needs an Analyst plan or above (Analyst, Lite, Pro or Enterprise); Basic-plan keys are refused. Use coingeckopro_get_onchain_wallet_transfers for token movements. Use coingeckopro_get_onchain_wallet_trades for DEX swaps and coingeckopro_get_onchain_wallet_balances for current holdings.
Inputs
networkstringrequired- GeckoTerminal network ID, for example eth, solana or base. Valid IDs come from coingeckopro_list_onchain_networks. Supported: eth, base, bsc, polygon_pos, arbitrum, optimism, avax, stable, robinhood, linea and arc.
wallet_addressstringrequired- The wallet address, for example 0x9642b23ed1e01df1092b92641051881a322f5d4e.
cursorstring- Cursor for the next page: pass meta.next_cursor from the previous response back unchanged. Omit for the first page; next_cursor is null on the last page.
directionstring- in for transfers received by the wallet, out for transfers it sent. Omit for both.one of
inout fromstring- Start of the range, as an ISO date YYYY-MM-DD or YYYY-MM-DDTHH:MM (recommended) or UNIX seconds, for example 2026-10-01. Give from and to together (up to 30 days apart); omit both for the last 7 days.
per_pageinteger- Number of transfers per page, 1 to 300. Default 100.
tostring- End of the range, as an ISO date YYYY-MM-DD or YYYY-MM-DDTHH:MM (recommended) or UNIX seconds, for example 2026-10-08. Give from and to together (up to 30 days apart); omit both for the last 7 days.
tokenstring- Only transfers of this token contract address, for example 0xdac17f958d2ee523a2206206994597c13d831ec7.
coingeckopro_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 coingeckopro_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.
coingeckopro_get_rwa_market_chartGet a tokenized real-world asset's historical price, market cap and 24-hour volume for the last N days, in USD.Read-onlyGet RWA Market Chart
Get a tokenized real-world asset's historical price, market cap and 24-hour volume for the last N days, in USD. Returns arrays tokenized_prices, tokenized_market_caps and tokenized_total_volumes of [UNIX ms, value] points for the on-chain tokenized market, not the underlying spot market. Granularity is automatic (5-minutely for 1 day, hourly for 2-90 days, daily beyond) unless interval is set. Needs a paid plan (Basic and above); Basic-plan keys reach the past 2 years; Analyst and above reach the full history. Use coingeckopro_get_rwa_market_chart for RWA price history. Use coingeckopro_get_rwa_tickers for where it trades and coingeckopro_get_coin_market_chart for ordinary coins.
Inputs
rwa_idstringrequired- CoinGecko RWA ID, for example gold or ibm. Valid IDs come from coingeckopro_list_rwas.
daysstring- How many days back from now to return: any whole number such as 1, 30 or 365, or max. Default 1.
intervalstring- Force the data interval: daily, hourly (past 100 days) or 5m (past 10 days, Enterprise only). Omit for automatic granularity.one of
5mhourlydaily 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
coingeckopro_get_rwa_tickersList where a tokenized real-world asset trades: the tickers of every token tracking it on centralized and decentralized exchanges, 100 per page.Read-onlyGet RWA Tickers
List where a tokenized real-world asset trades: the tickers of every token tracking it on centralized and decentralized exchanges, 100 per page. Returns the RWA name and a tickers array with exchange, base, target, last price, volume, converted price and volume, spread, trade URL and optional 2% order-book depth. Needs a paid plan (Basic and above). Use coingeckopro_get_rwa_tickers to see where an RWA trades. Use coingeckopro_get_rwa_market_chart for its price history and coingeckopro_get_coin_tickers for ordinary coins.
Inputs
rwa_idstringrequired- CoinGecko RWA ID, for example gold or ibm. Valid IDs come from coingeckopro_list_rwas.
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. Valid IDs come from coingeckopro_list_exchange_ids.
issuer_idsstring- Only return tickers for tokens from these RWA issuers, comma-separated, for example xstocks-ecosystem or coinbase-ecosystem.
orderstring- Sort order. Default last_traded_at_desc. Volume sorts use converted volume.one of
last_traded_at_desclast_traded_at_ascvolume_descvolume_asc pageinteger- Page number, starting at 1; each page holds 100 tickers.
coingeckopro_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 coingeckopro_get_simple_price for quick price checks. Use coingeckopro_get_token_price to look up tokens by contract address, and coingeckopro_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 coingeckopro_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).
coingeckopro_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 coingeckopro_get_token_price when you have a contract address. Use coingeckopro_get_simple_price for coin IDs or symbols, and coingeckopro_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 coingeckopro_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 coingeckopro_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
coingeckopro_get_top_gainers_losersGet the 30 coins with the largest price gain and the 30 with the largest loss over a chosen period.Read-onlyGet Top Gainers and Losers
Get the 30 coins with the largest price gain and the 30 with the largest loss over a chosen period. Returns top_gainers and top_losers arrays, each coin with id, symbol, name, image, market_cap_rank, price, 24-hour volume and price change for the period (plus extra timeframes when asked). Only coins with at least $50,000 of 24-hour volume are included. Needs an Analyst plan or above (Analyst, Lite, Pro or Enterprise); Basic-plan keys are refused. Use coingeckopro_get_top_gainers_losers for the biggest movers. Use coingeckopro_list_coins_markets to rank by market cap or volume and coingeckopro_get_trending for the most searched coins.
Inputs
vs_currencystringrequired- Currency to express prices and market data in, for example usd, eur or btc. Valid values come from coingeckopro_list_supported_vs_currencies.
durationstring- Period to measure the price change over: 1h, 24h (default), 7d, 14d, 30d, 60d or 1y.one of
1h24h7d14d30d60d1y price_change_percentagestring- Extra price-change timeframes to include, comma-separated, from 1h, 24h, 7d, 14d, 30d, 60d, 200d and 1y, for example 1h,30d.
top_coinsstring- Which coins to rank: the top 300, 500 or 1000 (default) by market cap, or all coins including ones without a market cap.one of
3005001000all
coingeckopro_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 6 trending categories. With show_max, Analyst plans and above get up to 30 coins, 10 NFTs and 10 categories. Use coingeckopro_get_trending for what people are watching now. Use coingeckopro_get_top_gainers_losers for the biggest price moves and coingeckopro_list_coins_markets for rankings by market cap or volume.
Inputs
show_maxstring- Return the maximum number of results for these types, comma-separated, from coins, nfts and categories, for example coins or coins,nfts,categories. Needs an Analyst plan or above.
coingeckopro_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 coingeckopro_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
coingeckopro_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 coingeckopro_list_categories to compare sectors. Use coingeckopro_list_category_ids for the plain ID list and coingeckopro_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
coingeckopro_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 coingeckopro_list_category_ids to find the category value for coingeckopro_list_coins_markets. Use coingeckopro_list_categories for categories with market cap and volume.
Inputs
This tool takes no inputs.
coingeckopro_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 coingeckopro_list_coins to resolve coin IDs for other tools. Use coingeckopro_search to find a coin by name, coingeckopro_list_new_coins for the latest listings, and coingeckopro_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 Basic-plan keys.one of
activeinactive
coingeckopro_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 coingeckopro_list_coins_markets for top-N lists, screeners and category views. Use coingeckopro_get_simple_price for a quick price only, coingeckopro_get_coin for one coin's full profile, and coingeckopro_get_top_gainers_losers for the biggest movers.
Inputs
vs_currencystringrequired- Currency to express prices and market data in, for example usd, eur or btc. Valid values come from coingeckopro_list_supported_vs_currencies.
categorystring- Category ID to limit results to, for example layer-1 or decentralized-finance-defi. Valid IDs come from coingeckopro_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).
coingeckopro_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 coingeckopro_list_derivatives to compare funding rates and open interest across venues. Use coingeckopro_list_derivatives_exchanges for venue-level totals.
Inputs
This tool takes no inputs.
coingeckopro_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 coingeckopro_list_derivatives_exchanges to rank derivatives venues. Use coingeckopro_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.
coingeckopro_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 coingeckopro_list_exchange_ids to resolve exchange IDs for other tools. Use coingeckopro_list_exchanges for volume, trust score and ranking.
Inputs
statusstring- active (default) for exchanges still listed, or inactive for delisted ones.one of
activeinactive
coingeckopro_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 coingeckopro_list_exchanges to rank or browse exchanges. Use coingeckopro_list_exchange_ids for every exchange ID in one call, and coingeckopro_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.
coingeckopro_list_insightsList the latest short coin insights published on CoinGecko, optionally for one coin or date range, up to 20 per page and 20 pages.Read-onlyList Insights
List the latest short coin insights published on CoinGecko, optionally for one coin or date range, up to 20 per page and 20 pages. Returns an array of insights with title, description, related_coin_ids and posted_at. Needs an Analyst plan or above (Analyst, Lite, Pro or Enterprise); Basic-plan keys are refused. Use coingeckopro_list_insights for brief takes on what is moving a coin. Use coingeckopro_list_news for full articles and guides.
Inputs
coin_idstring- Only return insights about this CoinGecko coin ID, for example solana. Valid IDs come from coingeckopro_list_coins.
fromstring- Only insights posted on or after this date, in YYYY-MM-DD format, for example 2026-10-01.
pageinteger- Page number, 1 to 20. Omit for page 1.
per_pageinteger- Number of insights per page, 1 to 20. Default 10.
tostring- Only insights posted on or before this date, in YYYY-MM-DD format, for example 2026-10-15.
coingeckopro_list_new_coinsList the 200 coins most recently listed on CoinGecko, newest first.Read-onlyList New Coins
List the 200 coins most recently listed on CoinGecko, newest first. Returns an array of {id, symbol, name, activated_at}, where activated_at is the UNIX time the coin was listed. Needs an Analyst plan or above (Analyst, Lite, Pro or Enterprise); Basic-plan keys are refused. Use coingeckopro_list_new_coins to discover fresh listings. Use coingeckopro_list_coins for every coin ID and coingeckopro_get_coin for a new coin's profile.
Inputs
This tool takes no inputs.
coingeckopro_list_newsList the latest crypto news articles and guides published on CoinGecko, optionally for one coin or language, up to 20 per page and 20 pages.Read-onlyList News
List the latest crypto news articles and guides published on CoinGecko, optionally for one coin or language, up to 20 per page and 20 pages. Returns an array of articles with title, url, image, author, posted_at, type (news or guide), source_name and related_coin_ids. Without coin_id only news is returned; with coin_id, news and guides. Needs an Analyst plan or above (Analyst, Lite, Pro or Enterprise); Basic-plan keys are refused. Use coingeckopro_list_news for articles. Use coingeckopro_list_insights for short AI-generated coin insights.
Inputs
coin_idstring- Only return articles about this CoinGecko coin ID, for example bitcoin. Valid IDs come from coingeckopro_list_coins.
languagestring- Article language. Default en.one of
enrudeplesvifrptarbgcsdaelfihehihrhuiditjakoltnlnoroskslsvthtrukzhzh-tw pageinteger- Page number, 1 to 20. Omit for page 1.
per_pageinteger- Number of articles per page, 1 to 20. Default 10.
typestring- all (default), news or guides. guides only works together with coin_id.one of
allnewsguides
coingeckopro_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 coingeckopro_list_nfts to find NFT collection IDs. Use coingeckopro_list_nfts_markets for collections with floor price, volume and market cap, and coingeckopro_get_nft for one collection's 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.
coingeckopro_list_nfts_marketsList NFT collections ranked by market cap (or volume) with market data, one page at a time.Read-onlyList NFTs Markets
List NFT collections ranked by market cap (or volume) with market data, one page at a time. Returns an array of collections with id, contract address, asset platform, name, symbol, image, floor price, market cap and 24-hour volume (native and USD) with their 24-hour changes, owners and supply. Illiquid collections may rank by volume rather than market cap. Needs an Analyst plan or above (Analyst, Lite, Pro or Enterprise); Basic-plan keys are refused. Use coingeckopro_list_nfts_markets to rank or screen NFT collections. Use coingeckopro_list_nfts for the plain ID list and coingeckopro_get_nft for one collection.
Inputs
asset_platform_idstring- Only list collections on this blockchain, for example ethereum. Valid IDs come from coingeckopro_list_asset_platforms with filter=nft.
orderstring- Sort order. Default market_cap_usd_desc.one of
h24_volume_native_asch24_volume_native_desch24_volume_usd_asch24_volume_usd_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.
coingeckopro_list_onchain_categoriesList GeckoTerminal's on-chain pool categories (such as pump-fun or ai-agents) with their market data, 50 per page.Read-onlyList Onchain Categories
List GeckoTerminal's on-chain pool categories (such as pump-fun or ai-agents) with their market data, 50 per page. Returns a JSON:API data array of categories with id, name, description, volume change percentages, reserve in USD, FDV in USD and 24-hour volume and transactions. These differ from CoinGecko coin categories. Needs an Analyst plan or above (Analyst, Lite, Pro or Enterprise); Basic-plan keys are refused. Use coingeckopro_list_onchain_categories to find category IDs for coingeckopro_list_onchain_category_pools. Use coingeckopro_list_categories for CoinGecko coin categories.
Inputs
pageinteger- Page number to return, starting at 1. Omit for page 1.
sortstring- Sort order. Default h6_volume_percentage_desc.one of
h1_volume_percentage_desch6_volume_percentage_desch12_volume_percentage_desch24_tx_count_desch24_volume_usd_descfdv_usd_descreserve_in_usd_desc
coingeckopro_list_onchain_category_poolsList the DEX pools in one GeckoTerminal category, 20 per page, newest first by default.Read-onlyList Onchain Category Pools
List the DEX pools in one GeckoTerminal category, 20 per page, newest first by default. Returns a JSON:API data array of pools with name, address, token prices in USD, FDV, market cap, reserve, price changes, transactions and volume, plus related objects under included when include is set. Needs an Analyst plan or above (Analyst, Lite, Pro or Enterprise); Basic-plan keys are refused. Use coingeckopro_list_onchain_category_pools to browse a sector's pools. Use coingeckopro_list_onchain_categories for category IDs and coingeckopro_filter_onchain_pools for numeric screens.
Inputs
category_idstringrequired- GeckoTerminal category ID, for example pump-fun. Valid IDs come from coingeckopro_list_onchain_categories.
includestring- Related objects to add under included, comma-separated, from base_token, quote_token, dex and network.
pageinteger- Page number to return, starting at 1. Omit for page 1.
sortstring- Sort order. Default pool_created_at_desc.one of
m5_trendingh1_trendingh6_trendingh24_trendingh24_tx_count_desch24_volume_usd_descpool_created_at_desch24_price_change_percentage_desc
coingeckopro_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 coingeckopro_list_onchain_networks to find network values for the onchain tools. Use coingeckopro_list_asset_platforms for the IDs the non-onchain tools use.
Inputs
pageinteger- Page number to return, starting at 1. Omit for page 1.
coingeckopro_list_onchain_trending_search_poolsList the DEX pools most searched on GeckoTerminal right now, across all networks.Read-onlyList Onchain Trending Search Pools
List the DEX pools most searched on GeckoTerminal right now, across all networks. Returns a JSON:API data array of pools (4 by default, up to 10) with name, address, token prices in USD, FDV, market cap, reserve, price changes, transactions and volume, plus related objects under included when include is set. Needs an Analyst plan or above (Analyst, Lite, Pro or Enterprise); Basic-plan keys are refused. Use coingeckopro_list_onchain_trending_search_pools for what on-chain traders are looking at. Use coingeckopro_get_trending for CoinGecko's trending coins and coingeckopro_filter_onchain_pools to screen pools.
Inputs
includestring- Related objects to add under included, comma-separated, from base_token, quote_token, dex and network.
poolsinteger- Number of pools to return, 1 to 10. Default 4.
coingeckopro_list_rwasList every tokenized real-world asset (RWA) CoinGecko tracks, such as tokenized stocks, commodities and ETFs, in one unpaginated response.Read-onlyList RWAs
List every tokenized real-world asset (RWA) CoinGecko tracks, such as tokenized stocks, commodities and ETFs, in one unpaginated response. Returns an array of {id, symbol, name, asset_type}, for example gold (XAU, commodity) or ibm (IBM, stock). Use coingeckopro_list_rwas to find the RWA ID for coingeckopro_get_rwa_tickers and coingeckopro_get_rwa_market_chart.
Inputs
asset_typestring- Only list RWAs of this type: stock, commodity or etf. Omit for all.one of
stockcommodityetf
coingeckopro_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.
coingeckopro_pingCheck that the CoinGecko Pro API is reachable and the connection's API key is accepted.Read-onlyPing
Check that the CoinGecko Pro API is reachable and the connection's API key is accepted. Returns a short status message (gecko_says). Use coingeckopro_ping to test the connection; it returns no market data. Use coingeckopro_get_api_usage for the plan, rate limit and remaining credits.
Inputs
This tool takes no inputs.
coingeckopro_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 coingeckopro_search to turn a name like 'solana' into the coin ID other tools need. Use coingeckopro_list_coins for the complete ID list and coingeckopro_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.
coingeckopro_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 coingeckopro_search_onchain_pools for on-chain and long-tail tokens. Use coingeckopro_filter_onchain_pools to screen pools by liquidity, volume or age, and coingeckopro_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 coingeckopro_list_onchain_networks.
pageinteger- Page number, starting at 1. Pages beyond 10 need an Analyst plan or above.
querystring- Pool contract address, token name, token symbol or token contract address, for example weth.
No tools match.
