> **Building with AI coding agents?** Install the authstack plugin with one command. This equips your agent with accurate Scalekit implementation patterns. > > **Recommended** (the `-y` flags skip prompts, so the command runs without an interactive terminal): > ```bash > npx -y @scalekit-inc/cli setup -y > ``` > > Global: > ```bash > npm install -g @scalekit-inc/cli > scalekit setup -y > ``` > > Supports Claude Code, Cursor, GitHub Copilot, Codex + skills for other Agent Skills-compatible agents in `~/.agents/skills`. > Skills: integrate-agentkit, implement-saaskit, add-mcp-oauth, implement-sso, implement-scim. > [Full setup guide](https://docs.scalekit.com/dev-kit/build-with-ai/) --- # Connect AI agents to CoinGecko Pro 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. **Authentication:** API Key **Categories:** Accounting & Finance, Analytics **Tools:** 74: 74 read, 0 write, 0 destructive **Users sign in with:** API key **Built by:** Scalekit connector **Try it:** [Playground in the Scalekit dashboard](https://app.scalekit.com/ws/signup?sk_intent=playground&provider=COINGECKOPRO) ## Setup 1. ### Install the SDK **Node.js** ```bash npm install @scalekit-sdk/node dotenv ``` **Python** ```bash pip install scalekit-sdk-python python-dotenv ``` 2. ### Set your credentials Add your Scalekit credentials to your `.env` file. Find values in **[app.scalekit.com](https://app.scalekit.com)** > **Developers** > **API Credentials**. ```sh title=".env" SCALEKIT_ENVIRONMENT_URL= SCALEKIT_CLIENT_ID= SCALEKIT_CLIENT_SECRET= ``` 3. ### Create the CoinGecko Pro connection In **AgentKit > Connections**, create a CoinGecko Pro connection. The name you give it is the `connection_name` your code passes. See [Configure connections](/agentkit/connections/). 4. ### Authorize a user and make your first call **Node.js** (`quickstart.mts`) ```typescript 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.actions const connector = 'coingeckopro' const identifier = 'user_123' // Generate an authorization link for the user const { 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 call const result = await actions.executeTool({ connector, identifier, toolName: 'coingeckopro_filter_onchain_pools', toolInput: {}, }) console.log(result) ``` ```bash npx tsx quickstart.mts ``` **Python** (`quickstart.py`) ```python import os from scalekit import ScalekitClient from dotenv import load_dotenv load_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.actions connection_name = "coingeckopro" identifier = "user_123" # Generate an authorization link for the user link_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 call result = actions.execute_tool( tool_input={}, tool_name="coingeckopro_filter_onchain_pools", connection_name=connection_name, identifier=identifier, ) print(result) ``` ```bash python quickstart.py ``` Each user opens the link once and enters their CoinGecko Pro credentials there. See [Authorize a user](/agentkit/tools/authorize/) for the full flow and statuses. ## Tools Pass the exact name to `execute_tool`, with an input like each tool's example. To ask for a tool that's missing, use the [request form](https://scalekitsupport.portal.usepylon.com/forms/request-a-connector-tool). **Node.js** ```typescript const result = await actions.executeTool({ toolName: 'coingeckopro_filter_onchain_pools', toolInput: {}, connector: 'coingeckopro', identifier: 'user_123', }) ``` **Python** ```python result = actions.execute_tool( tool_name="coingeckopro_filter_onchain_pools", tool_input={}, connection_name="coingeckopro", identifier="user_123", ) ``` `result.data` is the app's response as JSON, and `result.execution_id` (`executionId` in Node.js) is the ID of the call. ### `coingeckopro_filter_onchain_pools` Filter Onchain Pools · Read-only 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. Read only: yes. Destructive: no. Idempotent (safe to retry): yes. Inputs: - `buy_tax_percentage_max` (`number`, optional): Maximum token buy tax percentage, for example 5. - `buy_tax_percentage_min` (`number`, optional): Minimum token buy tax percentage, for example 0. - `buys_duration` (`string`, optional): Window the buys filter counts over: 5m, 1h, 6h or 24h (default). One of: `5m`, `1h`, `6h`, `24h`. - `buys_max` (`integer`, optional): Maximum number of buys in the buys_duration window, for example 50000. - `buys_min` (`integer`, optional): Minimum number of buys in the buys_duration window, for example 50. - `checks` (`string`, optional): 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. - `dexes` (`string`, optional): Only pools on these DEX IDs, comma-separated, for example uniswap_v3. Works only when networks names a single network. - `fdv_usd_max` (`number`, optional): Maximum fully diluted valuation in USD, for example 500000000. - `fdv_usd_min` (`number`, optional): Minimum fully diluted valuation in USD, for example 1000000. - `h24_volume_usd_max` (`number`, optional): Maximum 24-hour volume in USD, for example 50000000. - `h24_volume_usd_min` (`number`, optional): Minimum 24-hour volume in USD, for example 100000. - `holder_count_max` (`integer`, optional): Maximum number of token holders, for example 100000. - `holder_count_min` (`integer`, optional): Minimum number of token holders, for example 500. - `include` (`string`, optional): Related objects to add under included, comma-separated, from base_token, quote_token, dex and network. - `include_unknown_honeypot_tokens` (`boolean`, optional): With checks=no_honeypot, set to true to also keep tokens whose honeypot status is unknown. Default false. - `networks` (`string`, optional): Only pools on these GeckoTerminal network IDs, comma-separated, for example eth,base. Valid IDs come from coingeckopro_list_onchain_networks. - `page` (`integer`, optional): Page number to return, starting at 1. Omit for page 1. - `pool_created_hour_max` (`number`, optional): Maximum pool age in hours, for example 72. - `pool_created_hour_min` (`number`, optional): Minimum pool age in hours, for example 1. - `price_change_percentage_duration` (`string`, optional): Window the price change filter uses: 5m, 1h, 6h or 24h (default). One of: `5m`, `1h`, `6h`, `24h`. - `price_change_percentage_max` (`number`, optional): Maximum price change percentage over price_change_percentage_duration, for example 200. - `price_change_percentage_min` (`number`, optional): Minimum price change percentage over price_change_percentage_duration, for example -10. - `quote_token_addresses` (`string`, optional): Only pools whose quote token is one of these contract addresses, comma-separated, up to 50. - `quote_token_preset` (`string`, optional): Only pools whose quote token is in a preset group: rwa_stock for tokenized stocks. One of: `rwa_stock`. - `reserve_in_usd_max` (`number`, optional): Maximum pool liquidity reserve in USD, for example 10000000. - `reserve_in_usd_min` (`number`, optional): Minimum pool liquidity reserve in USD, for example 50000. - `sell_tax_percentage_max` (`number`, optional): Maximum token sell tax percentage, for example 5. - `sell_tax_percentage_min` (`number`, optional): Minimum token sell tax percentage, for example 0. - `sells_duration` (`string`, optional): Window the sells filter counts over: 5m, 1h, 6h or 24h (default). One of: `5m`, `1h`, `6h`, `24h`. - `sells_max` (`integer`, optional): Maximum number of sells in the sells_duration window, for example 50000. - `sells_min` (`integer`, optional): Minimum number of sells in the sells_duration window, for example 50. - `sort` (`string`, optional): Sort order. Default h6_trending. One of: `m5_trending`, `h1_trending`, `h6_trending`, `h24_trending`, `h24_tx_count_desc`, `h24_tx_count_asc`, `h24_volume_usd_desc`, `h24_volume_usd_asc`, `m5_price_change_percentage_asc`, `h1_price_change_percentage_asc`, `h6_price_change_percentage_asc`, `h24_price_change_percentage_asc`, `m5_price_change_percentage_desc`, `h1_price_change_percentage_desc`, `h6_price_change_percentage_desc`, `h24_price_change_percentage_desc`, `fdv_usd_asc`, `fdv_usd_desc`, `reserve_in_usd_asc`, `reserve_in_usd_desc`, `price_asc`, `price_desc`, `pool_created_at_desc`. - `top_10_holders_percentage_max` (`number`, optional): Maximum share of supply held by the top 10 holders, in percent, for example 40. - `top_10_holders_percentage_min` (`number`, optional): Minimum share of supply held by the top 10 holders, in percent, for example 5. - `tx_count_duration` (`string`, optional): Window the transactions filter counts over: 5m, 1h, 6h or 24h (default). One of: `5m`, `1h`, `6h`, `24h`. - `tx_count_max` (`integer`, optional): Maximum number of transactions in the tx_count_duration window, for example 100000. - `tx_count_min` (`integer`, optional): Minimum number of transactions in the tx_count_duration window, for example 100. Example input: `{}` ### `coingeckopro_get_api_usage` Get API Usage · Read-only 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. Read only: yes. Destructive: no. Idempotent (safe to retry): yes. Inputs: none. Example input: `{}` ### `coingeckopro_get_coin` Get Coin · Read-only 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. Read only: yes. Destructive: no. Idempotent (safe to retry): yes. Inputs: - `coin_id` (`string`, required): 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_format` (`string`, optional): How DEX ticker pairs show base and target: contract_address (default) or symbol, for example WETH/USDC. One of: `contract_address`, `symbol`. - `include_categories_details` (`boolean`, optional): Set to true to add category IDs and names in categories_details. Default false. - `localization` (`boolean`, optional): Set to false to drop the localized names and descriptions in every language, which shrinks the response a lot. Default true. - `market_data` (`boolean`, optional): Set to false to leave out market_data. Default true. - `sparkline` (`boolean`, optional): Set to true to add 7-day sparkline price data. Default false. - `tickers` (`boolean`, optional): Set to false to leave out exchange tickers. Default true. Example input: `{"coin_id":""}` ### `coingeckopro_get_coin_by_contract` Get Coin by Contract · Read-only 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. Read only: yes. Destructive: no. Idempotent (safe to retry): yes. Inputs: - `asset_platform_id` (`string`, required): CoinGecko asset platform (blockchain) ID, for example ethereum, solana or binance-smart-chain. Valid IDs come from coingeckopro_list_asset_platforms. - `contract_address` (`string`, required): The token's contract address on that platform, for example 0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2 (WETH on Ethereum). Example input: `{"asset_platform_id":"","contract_address":""}` ### `coingeckopro_get_coin_history` Get Coin History · Read-only 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. Read only: yes. Destructive: no. Idempotent (safe to retry): yes. Inputs: - `coin_id` (`string`, required): CoinGecko coin API ID, for example bitcoin or ethereum. This is the id from coingeckopro_list_coins or coingeckopro_search, not the ticker symbol. - `date` (`string`, required): The day to snapshot, in YYYY-MM-DD format, for example 2025-12-30. Basic-plan keys reach the past 2 years. - `localization` (`boolean`, optional): Set to false to drop localized names in every language. Default true. Example input: `{"coin_id":"","date":""}` ### `coingeckopro_get_coin_market_chart` Get Coin Market Chart · Read-only 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. Read only: yes. Destructive: no. Idempotent (safe to retry): yes. Inputs: - `coin_id` (`string`, required): CoinGecko coin API ID, for example bitcoin or ethereum. This is the id from coingeckopro_list_coins or coingeckopro_search, not the ticker symbol. - `days` (`string`, required): 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_currency` (`string`, required): Currency to express prices and market data in, for example usd, eur or btc. Valid values come from coingeckopro_list_supported_vs_currencies. - `interval` (`string`, optional): 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: `1m`, `5m`, `hourly`, `daily`. - `precision` (`string`, optional): Number of decimal places for price values, 0 to 18, or full for no rounding. Omit for CoinGecko's default rounding. One of: `full`, `0`, `1`, `2`, `3`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15`, `16`, `17`, `18`. Example input: `{"coin_id":"","days":"","vs_currency":""}` ### `coingeckopro_get_coin_market_chart_range` Get Coin Market Chart Range · Read-only 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. Read only: yes. Destructive: no. Idempotent (safe to retry): yes. Inputs: - `coin_id` (`string`, required): CoinGecko coin API ID, for example bitcoin or ethereum. This is the id from coingeckopro_list_coins or coingeckopro_search, not the ticker symbol. - `from` (`string`, required): 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. - `to` (`string`, required): 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_currency` (`string`, required): Currency to express prices and market data in, for example usd, eur or btc. Valid values come from coingeckopro_list_supported_vs_currencies. - `interval` (`string`, optional): 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: `1m`, `5m`, `hourly`, `daily`. - `precision` (`string`, optional): Number of decimal places for price values, 0 to 18, or full for no rounding. Omit for CoinGecko's default rounding. One of: `full`, `0`, `1`, `2`, `3`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15`, `16`, `17`, `18`. Example input: `{"coin_id":"","from":"","to":"","vs_currency":""}` ### `coingeckopro_get_coin_ohlc` Get Coin OHLC · Read-only 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. Read only: yes. Destructive: no. Idempotent (safe to retry): yes. Inputs: - `coin_id` (`string`, required): CoinGecko coin API ID, for example bitcoin or ethereum. This is the id from coingeckopro_list_coins or coingeckopro_search, not the ticker symbol. - `days` (`string`, required): How many days back from now to return: 1, 7, 14, 30, 90, 180, 365 or max. One of: `1`, `7`, `14`, `30`, `90`, `180`, `365`, `max`. - `vs_currency` (`string`, required): Currency to express prices and market data in, for example usd, eur or btc. Valid values come from coingeckopro_list_supported_vs_currencies. - `interval` (`string`, optional): 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: `daily`, `hourly`. - `precision` (`string`, optional): Number of decimal places for price values, 0 to 18, or full for no rounding. Omit for CoinGecko's default rounding. One of: `full`, `0`, `1`, `2`, `3`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15`, `16`, `17`, `18`. Example input: `{"coin_id":"","days":"1","vs_currency":""}` ### `coingeckopro_get_coin_ohlc_range` Get Coin OHLC Range · Read-only 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. Read only: yes. Destructive: no. Idempotent (safe to retry): yes. Inputs: - `coin_id` (`string`, required): CoinGecko coin API ID, for example bitcoin or ethereum. This is the id from coingeckopro_list_coins or coingeckopro_search, not the ticker symbol. - `from` (`string`, required): 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. - `interval` (`string`, required): Candle size: daily (up to 180 days per request) or hourly (up to 31 days per request). One of: `daily`, `hourly`. - `to` (`string`, required): 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_currency` (`string`, required): Currency to express prices and market data in, for example usd, eur or btc. Valid values come from coingeckopro_list_supported_vs_currencies. Example input: `{"coin_id":"","from":"","interval":"daily","to":"","vs_currency":""}` ### `coingeckopro_get_coin_supply_breakdown` Get Coin Supply Breakdown · Read-only 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. Read only: yes. Destructive: no. Idempotent (safe to retry): yes. Inputs: - `coin_id` (`string`, required): CoinGecko coin API ID, for example uniswap. Check has_supply_breakdown in coingeckopro_get_coin first: not every coin has a breakdown. Example input: `{"coin_id":""}` ### `coingeckopro_get_coin_supply_chart` Get Coin Supply Chart · Read-only 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. Read only: yes. Destructive: no. Idempotent (safe to retry): yes. Inputs: - `coin_id` (`string`, required): CoinGecko coin API ID, for example bitcoin or ethereum. This is the id from coingeckopro_list_coins or coingeckopro_search, not the ticker symbol. - `days` (`string`, required): How many days back from now to return: any whole number such as 1, 30 or 365, or max for the full history. - `supply_type` (`string`, required): Which supply series to return: circulating_supply or total_supply. One of: `circulating_supply`, `total_supply`. - `interval` (`string`, optional): Force the data interval: daily for either supply type; 5m or hourly for circulating_supply only. Omit for automatic granularity. One of: `5m`, `hourly`, `daily`. Example input: `{"coin_id":"","days":"","supply_type":"circulating_supply"}` ### `coingeckopro_get_coin_supply_chart_range` Get Coin Supply Chart Range · Read-only 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'. Read only: yes. Destructive: no. Idempotent (safe to retry): yes. Inputs: - `coin_id` (`string`, required): CoinGecko coin API ID, for example bitcoin or ethereum. This is the id from coingeckopro_list_coins or coingeckopro_search, not the ticker symbol. - `from` (`string`, required): 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_type` (`string`, required): Which supply series to return: circulating_supply or total_supply. One of: `circulating_supply`, `total_supply`. - `to` (`string`, required): 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. Example input: `{"coin_id":"","from":"","supply_type":"circulating_supply","to":""}` ### `coingeckopro_get_coin_tickers` Get Coin Tickers · Read-only 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. Read only: yes. Destructive: no. Idempotent (safe to retry): yes. Inputs: - `coin_id` (`string`, required): CoinGecko coin API ID, for example bitcoin or ethereum. This is the id from coingeckopro_list_coins or coingeckopro_search, not the ticker symbol. - `depth` (`boolean`, optional): Set to true to add 2% order-book depth (cost_to_move_up_usd and cost_to_move_down_usd). Default false. - `dex_pair_format` (`string`, optional): How DEX ticker pairs show base and target: contract_address (default) or symbol, for example WETH/USDC. One of: `contract_address`, `symbol`. - `exchange_ids` (`string`, optional): Only return tickers on these exchanges, by CoinGecko exchange ID, for example binance. - `include_exchange_logo` (`boolean`, optional): Set to true to add each exchange's logo URL. Default false. - `order` (`string`, optional): Sort order. Default trust_score_desc. Volume sorts use converted volume. One of: `trust_score_desc`, `trust_score_asc`, `volume_desc`, `volume_asc`. - `page` (`integer`, optional): Page number, starting at 1; each page holds 100 tickers. Example input: `{"coin_id":""}` ### `coingeckopro_get_contract_market_chart` Get Contract Market Chart · Read-only 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. Read only: yes. Destructive: no. Idempotent (safe to retry): yes. Inputs: - `asset_platform_id` (`string`, required): CoinGecko asset platform (blockchain) ID, for example ethereum, solana or binance-smart-chain. Valid IDs come from coingeckopro_list_asset_platforms. - `contract_address` (`string`, required): The token's contract address on that platform, for example 0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48 (USDC on Ethereum). - `days` (`string`, required): 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_currency` (`string`, required): Currency to express prices and market data in, for example usd, eur or btc. Valid values come from coingeckopro_list_supported_vs_currencies. - `interval` (`string`, optional): 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: `1m`, `5m`, `hourly`, `daily`. - `precision` (`string`, optional): Number of decimal places for price values, 0 to 18, or full for no rounding. Omit for CoinGecko's default rounding. One of: `full`, `0`, `1`, `2`, `3`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15`, `16`, `17`, `18`. Example input: `{"asset_platform_id":"","contract_address":"","days":"","vs_currency":""}` ### `coingeckopro_get_contract_market_chart_range` Get Contract Market Chart Range · Read-only 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. Read only: yes. Destructive: no. Idempotent (safe to retry): yes. Inputs: - `asset_platform_id` (`string`, required): CoinGecko asset platform (blockchain) ID, for example ethereum, solana or binance-smart-chain. Valid IDs come from coingeckopro_list_asset_platforms. - `contract_address` (`string`, required): The token's contract address on that platform, for example 0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48 (USDC on Ethereum). - `from` (`string`, required): 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. - `to` (`string`, required): 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_currency` (`string`, required): Currency to express prices and market data in, for example usd, eur or btc. Valid values come from coingeckopro_list_supported_vs_currencies. - `interval` (`string`, optional): 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: `1m`, `5m`, `hourly`, `daily`. - `precision` (`string`, optional): Number of decimal places for price values, 0 to 18, or full for no rounding. Omit for CoinGecko's default rounding. One of: `full`, `0`, `1`, `2`, `3`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15`, `16`, `17`, `18`. Example input: `{"asset_platform_id":"","contract_address":"","from":"","to":"","vs_currency":""}` ### `coingeckopro_get_derivatives_exchange` Get Derivatives Exchange · Read-only 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. Read only: yes. Destructive: no. Idempotent (safe to retry): yes. Inputs: - `exchange_id` (`string`, required): CoinGecko derivatives exchange ID, for example binance_futures or bybit. Find IDs with coingeckopro_list_derivatives_exchanges. - `include_tickers` (`string`, optional): Add tickers: all for every contract, or unexpired for contracts that have not expired. Omit to leave tickers out. One of: `all`, `unexpired`. Example input: `{"exchange_id":""}` ### `coingeckopro_get_exchange` Get Exchange · Read-only 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. Read only: yes. Destructive: no. Idempotent (safe to retry): yes. Inputs: - `exchange_id` (`string`, required): CoinGecko exchange ID, for example binance or gdax. Valid IDs come from coingeckopro_list_exchange_ids. - `dex_pair_format` (`string`, optional): How DEX ticker pairs show base and target: contract_address (default) or symbol, for example WETH/USDC. One of: `contract_address`, `symbol`. Example input: `{"exchange_id":""}` ### `coingeckopro_get_exchange_rates` Get Exchange Rates · Read-only 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. Read only: yes. Destructive: no. Idempotent (safe to retry): yes. Inputs: none. Example input: `{}` ### `coingeckopro_get_exchange_tickers` Get Exchange Tickers · Read-only 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. Read only: yes. Destructive: no. Idempotent (safe to retry): yes. Inputs: - `exchange_id` (`string`, required): CoinGecko exchange ID, for example binance. Valid IDs come from coingeckopro_list_exchange_ids. - `coin_ids` (`string`, optional): Only return tickers for these CoinGecko coin IDs, comma-separated, for example bitcoin,ethereum. - `depth` (`boolean`, optional): Set to true to add 2% order-book depth (cost_to_move_up_usd and cost_to_move_down_usd). Default false. - `dex_pair_format` (`string`, optional): How DEX ticker pairs show base and target: contract_address (default) or symbol, for example WETH/USDC. One of: `contract_address`, `symbol`. - `include_exchange_logo` (`boolean`, optional): Set to true to add the exchange logo URL. Default false. - `order` (`string`, optional): Sort order. Default trust_score_desc. Use base_target for stable pagination across pages. One of: `market_cap_asc`, `market_cap_desc`, `trust_score_desc`, `trust_score_asc`, `volume_desc`, `volume_asc`, `base_target`. - `page` (`integer`, optional): Page number, starting at 1; each page holds 100 tickers. Example input: `{"exchange_id":""}` ### `coingeckopro_get_exchange_volume_chart` Get Exchange Volume Chart · Read-only 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. Read only: yes. Destructive: no. Idempotent (safe to retry): yes. Inputs: - `days` (`string`, required): How many days back from now to return: 1, 7, 14, 30, 90, 180 or 365. One of: `1`, `7`, `14`, `30`, `90`, `180`, `365`. - `exchange_id` (`string`, required): CoinGecko exchange ID or derivatives exchange ID, for example binance or binance_futures. Example input: `{"days":"1","exchange_id":""}` ### `coingeckopro_get_exchange_volume_chart_range` Get Exchange Volume Chart Range · Read-only 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. Read only: yes. Destructive: no. Idempotent (safe to retry): yes. Inputs: - `exchange_id` (`string`, required): CoinGecko exchange ID or derivatives exchange ID, for example binance or binance_futures. Valid IDs come from coingeckopro_list_exchange_ids. - `from` (`integer`, required): Start of the range as a UNIX timestamp in seconds, for example 1767225600 (2026-01-01). The range must be 31 days or less. - `to` (`integer`, required): End of the range as a UNIX timestamp in seconds, for example 1769817600 (2026-01-31). Example input: `{"exchange_id":"","from":1,"to":1}` ### `coingeckopro_get_global` Get Global Market Data · Read-only 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. Read only: yes. Destructive: no. Idempotent (safe to retry): yes. Inputs: none. Example input: `{}` ### `coingeckopro_get_global_defi` Get Global DeFi Data · Read-only 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. Read only: yes. Destructive: no. Idempotent (safe to retry): yes. Inputs: none. Example input: `{}` ### `coingeckopro_get_global_market_cap_chart` Get Global Market Cap Chart · Read-only 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. Read only: yes. Destructive: no. Idempotent (safe to retry): yes. Inputs: - `days` (`string`, required): How many days back from now to return: 1, 7, 14, 30, 90, 180, 365 or max. One of: `1`, `7`, `14`, `30`, `90`, `180`, `365`, `max`. - `vs_currency` (`string`, optional): 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. Example input: `{"days":"1"}` ### `coingeckopro_get_nft` Get NFT Collection · Read-only 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. Read only: yes. Destructive: no. Idempotent (safe to retry): yes. Inputs: - `nft_id` (`string`, required): CoinGecko NFT collection ID, for example pudgy-penguins. Valid IDs come from coingeckopro_list_nfts. Example input: `{"nft_id":""}` ### `coingeckopro_get_nft_by_contract` Get NFT Collection by Contract · Read-only 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. Read only: yes. Destructive: no. Idempotent (safe to retry): yes. Inputs: - `asset_platform_id` (`string`, required): 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_address` (`string`, required): The NFT collection's contract address on that platform, for example 0xBd3531dA5CF5857e7CfAA92426877b022e612cf8 (Pudgy Penguins). Example input: `{"asset_platform_id":"","contract_address":""}` ### `coingeckopro_get_nft_market_chart` Get NFT Market Chart · Read-only 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. Read only: yes. Destructive: no. Idempotent (safe to retry): yes. Inputs: - `days` (`string`, required): How many days back from now to return: any whole number such as 1, 30 or 365, or max. - `nft_id` (`string`, required): CoinGecko NFT collection ID, for example pudgy-penguins. Valid IDs come from coingeckopro_list_nfts. Example input: `{"days":"","nft_id":""}` ### `coingeckopro_get_nft_market_chart_by_contract` Get NFT Market Chart by Contract · Read-only 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). Read only: yes. Destructive: no. Idempotent (safe to retry): yes. Inputs: - `asset_platform_id` (`string`, required): 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_address` (`string`, required): The NFT collection's contract address on that platform, for example 0xBd3531dA5CF5857e7CfAA92426877b022e612cf8 (Pudgy Penguins). - `days` (`string`, required): How many days back from now to return: any whole number such as 1, 30 or 365, or max. Example input: `{"asset_platform_id":"","contract_address":"","days":""}` ### `coingeckopro_get_nft_tickers` Get NFT Tickers · Read-only 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. Read only: yes. Destructive: no. Idempotent (safe to retry): yes. Inputs: - `nft_id` (`string`, required): CoinGecko NFT collection ID, for example pudgy-penguins. Valid IDs come from coingeckopro_list_nfts. Example input: `{"nft_id":""}` ### `coingeckopro_get_onchain_holders_chart` Get Onchain Holders Chart · Read-only 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. Read only: yes. Destructive: no. Idempotent (safe to retry): yes. Inputs: - `network` (`string`, required): 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_address` (`string`, required): The token's contract address on that network, for example Dfh5DzRgSvvCFDoYc2ciTkMrbDfRKybA4SoFbPmApump. - `days` (`string`, optional): Period to return: 7 (default), 30 or max. One of: `7`, `30`, `max`. Example input: `{"network":"","token_address":""}` ### `coingeckopro_get_onchain_pool_liquidity_events` Get Onchain Pool Liquidity Events · Read-only 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. Read only: yes. Destructive: no. Idempotent (safe to retry): yes. Inputs: - `network` (`string`, required): GeckoTerminal network ID, for example eth, solana or base. Valid IDs come from coingeckopro_list_onchain_networks. Only solana is supported here. - `pool_address` (`string`, required): The pool's address, for example G9YxfMcZQiW7EmsU1Asxuomcm5iQrBDKpbozuTM2iwne (a PumpSwap or Meteora DAMM v2 pool on Solana). - `cursor` (`string`, optional): 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. - `kind` (`string`, optional): Only add or only remove events. Omit for both. One of: `add`, `remove`. - `per_page` (`integer`, optional): Number of events per page, 1 to 50. Default 20. - `volume_in_usd_greater_than` (`number`, optional): Only events worth more than this many US dollars (a positive number), for example 500. Example input: `{"network":"","pool_address":""}` ### `coingeckopro_get_onchain_pool_trades_range` Get Onchain Pool Trades Range · Read-only 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. Read only: yes. Destructive: no. Idempotent (safe to retry): yes. Inputs: - `from` (`string`, required): 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. - `network` (`string`, required): GeckoTerminal network ID, for example eth, solana or base. Valid IDs come from coingeckopro_list_onchain_networks. - `pool_address` (`string`, required): The pool's contract address on that network, for example 0x06da0fd433c1a5d7a4faa01111c044910a184553. Find pools with coingeckopro_search_onchain_pools. - `to` (`string`, required): 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. - `cursor` (`string`, optional): 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_anomalous` (`boolean`, optional): Set to true to include trades flagged as anomalous. Default false. - `per_page` (`integer`, optional): Number of trades per page, 1 to 300. Default 100. - `token` (`string`, optional): 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_than` (`number`, optional): Only trades worth more than this many US dollars, for example 1000. Default 0. Example input: `{"from":"","network":"","pool_address":"","to":""}` ### `coingeckopro_get_onchain_token_ohlcv` Get Onchain Token OHLCV · Read-only 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. Read only: yes. Destructive: no. Idempotent (safe to retry): yes. Inputs: - `network` (`string`, required): GeckoTerminal network ID, for example eth, solana or base. Valid IDs come from coingeckopro_list_onchain_networks. - `timeframe` (`string`, required): Candle unit: day, hour, minute or second. Combine with aggregate for multi-unit candles. One of: `day`, `hour`, `minute`, `second`. - `token_address` (`string`, required): The token's contract address on that network, for example So11111111111111111111111111111111111111112. - `aggregate` (`string`, optional): 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_timestamp` (`integer`, optional): Only return candles before this UNIX time in seconds, for example 1767225600, to page back through history. - `currency` (`string`, optional): Price candles in usd (default) or in the quote token. One of: `usd`, `token`. - `include_empty_intervals` (`boolean`, optional): Set to true to fill intervals with no trades (OHLC repeats the previous close, volume 0). Default false. - `include_inactive_source` (`boolean`, optional): Set to true to use inactive pools' most recent swaps when the token has no active pool. Default false. - `limit` (`integer`, optional): Number of candles to return, up to 1000. Default 100. Example input: `{"network":"","timeframe":"day","token_address":""}` ### `coingeckopro_get_onchain_token_price` Get Onchain Token Price · Read-only 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. Read only: yes. Destructive: no. Idempotent (safe to retry): yes. Inputs: - `addresses` (`string`, required): Token contract addresses on that network, comma-separated: up to 30, or up to 100 on Analyst plans and above. - `network` (`string`, required): GeckoTerminal network ID, for example eth, solana or base. Valid IDs come from coingeckopro_list_onchain_networks. - `include_24hr_price_change` (`boolean`, optional): Set to true to add the 24-hour price change percentage. Default false. - `include_24hr_vol` (`boolean`, optional): Set to true to add 24-hour volume. Default false. - `include_inactive_source` (`boolean`, optional): Set to true to fall back to recently active pools (up to 1 year) when no top pool is found. Default false. - `include_market_cap` (`boolean`, optional): Set to true to add market cap (null for unverified tokens unless mcap_fdv_fallback is true). Default false. - `include_total_reserve_in_usd` (`boolean`, optional): Set to true to add total liquidity reserve in USD. Default false. - `mcap_fdv_fallback` (`boolean`, optional): Set to true to return fully diluted valuation when market cap is unavailable. Default false. Example input: `{"addresses":"","network":""}` ### `coingeckopro_get_onchain_token_price_multi` Get Onchain Token Price Across Networks · Read-only 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. Read only: yes. Destructive: no. Idempotent (safe to retry): yes. Inputs: - `tokens` (`string`, required): 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_change` (`boolean`, optional): Set to true to add the 24-hour price change percentage. Default false. - `include_24hr_vol` (`boolean`, optional): Set to true to add 24-hour volume. Default false. - `include_inactive_source` (`boolean`, optional): Set to true to fall back to recently active pools (up to 1 year) when no top pool is found. Default false. - `include_market_cap` (`boolean`, optional): Set to true to add market cap (null for unverified tokens unless mcap_fdv_fallback is true). Default false. - `include_total_reserve_in_usd` (`boolean`, optional): Set to true to add total liquidity reserve in USD. Default false. - `mcap_fdv_fallback` (`boolean`, optional): Set to true to return fully diluted valuation when market cap is unavailable. Default false. Example input: `{"tokens":""}` ### `coingeckopro_get_onchain_token_trades` Get Onchain Token Trades · Read-only 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. Read only: yes. Destructive: no. Idempotent (safe to retry): yes. Inputs: - `network` (`string`, required): GeckoTerminal network ID, for example eth, solana or base. Valid IDs come from coingeckopro_list_onchain_networks. - `token_address` (`string`, required): The token's contract address on that network, for example 0xdac17f958d2ee523a2206206994597c13d831ec7. - `cursor` (`string`, optional): 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_anomalous` (`boolean`, optional): Set to true to include trades flagged as anomalous. Default false. - `per_page` (`integer`, optional): Number of trades per page, 1 to 300. Default 300. - `trade_volume_in_usd_greater_than` (`number`, optional): Only trades worth more than this many US dollars, for example 1000. Default 0. - `trading_period` (`string`, optional): How far back to look: 1d (default), 7d or 30d. One of: `1d`, `7d`, `30d`. Example input: `{"network":"","token_address":""}` ### `coingeckopro_get_onchain_token_trades_range` Get Onchain Token Trades Range · Read-only 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. Read only: yes. Destructive: no. Idempotent (safe to retry): yes. Inputs: - `from` (`string`, required): 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. - `network` (`string`, required): GeckoTerminal network ID, for example eth, solana or base. Valid IDs come from coingeckopro_list_onchain_networks. - `to` (`string`, required): 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_address` (`string`, required): The token's contract address on that network, for example 0xdac17f958d2ee523a2206206994597c13d831ec7. - `cursor` (`string`, optional): 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_anomalous` (`boolean`, optional): Set to true to include trades flagged as anomalous. Default false. - `per_page` (`integer`, optional): Number of trades per page, 1 to 300. Default 100. - `trade_volume_in_usd_greater_than` (`number`, optional): Only trades worth more than this many US dollars, for example 1000. Default 0. Example input: `{"from":"","network":"","to":"","token_address":""}` ### `coingeckopro_get_onchain_tokens_multi` Get Onchain Tokens Across Networks · Read-only 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. Read only: yes. Destructive: no. Idempotent (safe to retry): yes. Inputs: - `tokens` (`string`, required): 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. - `include` (`string`, optional): Set to top_pools to add each token's top pools under included. One of: `top_pools`. - `include_composition` (`boolean`, optional): With include=top_pools, set to true to add each pool's base and quote token balances and liquidity. Default false. - `include_inactive_source` (`boolean`, optional): Set to true to fall back to the most recent swap in inactive pools when a token has no active pool. Default false. Example input: `{"tokens":""}` ### `coingeckopro_get_onchain_top_holders` Get Onchain Top Holders · Read-only 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. Read only: yes. Destructive: no. Idempotent (safe to retry): yes. Inputs: - `network` (`string`, required): 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_address` (`string`, required): The token's contract address on that network, for example Dfh5DzRgSvvCFDoYc2ciTkMrbDfRKybA4SoFbPmApump. - `holders` (`string`, optional): Number of top holders to return: a whole number up to 50 (40 on Solana), or max. Default 10. - `include_pnl_details` (`boolean`, optional): Set to true to add each holder's average buy price, realized and unrealized PnL. Default false. Example input: `{"network":"","token_address":""}` ### `coingeckopro_get_onchain_top_traders` Get Onchain Top Traders · Read-only 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. Read only: yes. Destructive: no. Idempotent (safe to retry): yes. Inputs: - `network` (`string`, required): GeckoTerminal network ID, for example eth, solana or base. Valid IDs come from coingeckopro_list_onchain_networks. - `token_address` (`string`, required): The token's contract address on that network, for example Dfh5DzRgSvvCFDoYc2ciTkMrbDfRKybA4SoFbPmApump. - `include_address_label` (`boolean`, optional): Set to true to add known labels for trader addresses (for example exchanges). Default false. - `sort` (`string`, optional): 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_desc`, `unrealized_pnl_usd_desc`, `total_buy_usd_desc`, `total_sell_usd_desc`, `token_balance_desc`. - `traders` (`string`, optional): Number of top traders to return: a whole number up to 50, or max. Default 10. Example input: `{"network":"","token_address":""}` ### `coingeckopro_get_onchain_wallet_balances` Get Onchain Wallet Balances · Read-only 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. Read only: yes. Destructive: no. Idempotent (safe to retry): yes. Inputs: - `networks` (`string`, required): 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_address` (`string`, required): The wallet address, for example 0x9642b23ed1e01df1092b92641051881a322f5d4e. - `page` (`integer`, optional): Page number to return, starting at 1. Omit for page 1. - `per_page` (`integer`, optional): Number of holdings per page, 1 to 100. Default 50. - `reserve_in_usd_min` (`number`, optional): Only tokens whose pools hold at least this much liquidity in USD, for example 10000, to skip spam tokens. - `sort` (`string`, optional): value_usd_desc (default) or value_usd_asc. One of: `value_usd_desc`, `value_usd_asc`. - `token_type` (`string`, optional): Only native tokens or only non_native tokens (ERC-20, SPL). Omit for both. One of: `native`, `non_native`. - `value_usd_min` (`number`, optional): Only holdings worth at least this many US dollars, for example 10. Example input: `{"networks":"","wallet_address":""}` ### `coingeckopro_get_onchain_wallet_pnl` Get Onchain Wallet PnL · Read-only 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. Read only: yes. Destructive: no. Idempotent (safe to retry): yes. Inputs: - `networks` (`string`, required): Networks to read, comma-separated, all from the same VM family (mixing families returns 400), for example eth,base. - `wallet_address` (`string`, required): The wallet address, for example 0x4b3f1048c55faa0c0873e249e541139360501f2a. - `page` (`integer`, optional): Page number to return, starting at 1. Omit for page 1. - `per_page` (`integer`, optional): Number of tokens per page, 1 to 300. Default 100. - `sort` (`string`, optional): 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_desc`, `unrealized_pnl_usd_desc`, `total_buy_usd_desc`, `total_sell_usd_desc`. Example input: `{"networks":"","wallet_address":""}` ### `coingeckopro_get_onchain_wallet_trades` Get Onchain Wallet Trades · Read-only 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. Read only: yes. Destructive: no. Idempotent (safe to retry): yes. Inputs: - `network` (`string`, required): GeckoTerminal network ID, for example eth, solana or base. Valid IDs come from coingeckopro_list_onchain_networks. - `wallet_address` (`string`, required): The wallet address, for example 0x7942262a7a5637e6eb0eec9b91b55ec232141f87. - `cursor` (`string`, optional): 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. - `from` (`string`, optional): 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_anomalous` (`boolean`, optional): Set to true to include trades flagged as anomalous. Default false. - `per_page` (`integer`, optional): Number of trades per page, 1 to 300. Default 100. - `to` (`string`, optional): 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. - `token` (`string`, optional): Only trades involving this token contract address, for example 0xdac17f958d2ee523a2206206994597c13d831ec7. Example input: `{"network":"","wallet_address":""}` ### `coingeckopro_get_onchain_wallet_transfers` Get Onchain Wallet Transfers · Read-only 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. Read only: yes. Destructive: no. Idempotent (safe to retry): yes. Inputs: - `network` (`string`, required): 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_address` (`string`, required): The wallet address, for example 0x9642b23ed1e01df1092b92641051881a322f5d4e. - `cursor` (`string`, optional): 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. - `direction` (`string`, optional): in for transfers received by the wallet, out for transfers it sent. Omit for both. One of: `in`, `out`. - `from` (`string`, optional): 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_page` (`integer`, optional): Number of transfers per page, 1 to 300. Default 100. - `to` (`string`, optional): 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. - `token` (`string`, optional): Only transfers of this token contract address, for example 0xdac17f958d2ee523a2206206994597c13d831ec7. Example input: `{"network":"","wallet_address":""}` ### `coingeckopro_get_public_treasury` Get Public Treasury Holdings · Read-only 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. Read only: yes. Destructive: no. Idempotent (safe to retry): yes. Inputs: - `coin_id` (`string`, required): CoinGecko coin ID of the treasury asset, for example bitcoin, ethereum, solana or binancecoin. - `entity` (`string`, required): Whose holdings to list: companies (public companies) or governments. One of: `companies`, `governments`. - `order` (`string`, optional): Sort order. Default total_holdings_usd_desc. One of: `total_holdings_usd_desc`, `total_holdings_usd_asc`. - `page` (`integer`, optional): Page number to return, starting at 1. Omit for page 1. - `per_page` (`integer`, optional): Number of results per page, 1 to 250. Omit for CoinGecko's default of 250. Example input: `{"coin_id":"","entity":"companies"}` ### `coingeckopro_get_rwa_market_chart` Get RWA Market Chart · Read-only 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. Read only: yes. Destructive: no. Idempotent (safe to retry): yes. Inputs: - `rwa_id` (`string`, required): CoinGecko RWA ID, for example gold or ibm. Valid IDs come from coingeckopro_list_rwas. - `days` (`string`, optional): How many days back from now to return: any whole number such as 1, 30 or 365, or max. Default 1. - `interval` (`string`, optional): Force the data interval: daily, hourly (past 100 days) or 5m (past 10 days, Enterprise only). Omit for automatic granularity. One of: `5m`, `hourly`, `daily`. - `precision` (`string`, optional): Number of decimal places for price values, 0 to 18, or full for no rounding. Omit for CoinGecko's default rounding. One of: `full`, `0`, `1`, `2`, `3`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15`, `16`, `17`, `18`. Example input: `{"rwa_id":""}` ### `coingeckopro_get_rwa_tickers` Get RWA Tickers · Read-only 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. Read only: yes. Destructive: no. Idempotent (safe to retry): yes. Inputs: - `rwa_id` (`string`, required): CoinGecko RWA ID, for example gold or ibm. Valid IDs come from coingeckopro_list_rwas. - `depth` (`boolean`, optional): Set to true to add 2% order-book depth (cost_to_move_up_usd and cost_to_move_down_usd). Default false. - `dex_pair_format` (`string`, optional): How DEX ticker pairs show base and target: contract_address (default) or symbol, for example WETH/USDC. One of: `contract_address`, `symbol`. - `exchange_ids` (`string`, optional): Only return tickers on these exchanges, by CoinGecko exchange ID, for example binance. Valid IDs come from coingeckopro_list_exchange_ids. - `issuer_ids` (`string`, optional): Only return tickers for tokens from these RWA issuers, comma-separated, for example xstocks-ecosystem or coinbase-ecosystem. - `order` (`string`, optional): Sort order. Default last_traded_at_desc. Volume sorts use converted volume. One of: `last_traded_at_desc`, `last_traded_at_asc`, `volume_desc`, `volume_asc`. - `page` (`integer`, optional): Page number, starting at 1; each page holds 100 tickers. Example input: `{"rwa_id":""}` ### `coingeckopro_get_simple_price` Get Simple Price · Read-only 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. Read only: yes. Destructive: no. Idempotent (safe to retry): yes. Inputs: - `vs_currencies` (`string`, required): Currencies to price the coins in, comma-separated, for example usd or usd,eur,btc. Valid values come from coingeckopro_list_supported_vs_currencies. - `ids` (`string`, optional): 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_change` (`boolean`, optional): Set to true to add the 24-hour price change percentage for each currency (null when the price is stale). Default false. - `include_24hr_vol` (`boolean`, optional): Set to true to add 24-hour trading volume for each currency. Default false. - `include_last_updated_at` (`boolean`, optional): Set to true to add last_updated_at, the UNIX time of the latest price. Default false. - `include_market_cap` (`boolean`, optional): Set to true to add market capitalization for each currency. Default false. - `include_tokens` (`string`, optional): 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: `top`, `all`. - `names` (`string`, optional): Coin names, comma-separated, for example Bitcoin,Ethereum. Used when ids is empty. - `precision` (`string`, optional): Number of decimal places for price values, 0 to 18, or full for no rounding. Omit for CoinGecko's default rounding. One of: `full`, `0`, `1`, `2`, `3`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15`, `16`, `17`, `18`. - `symbols` (`string`, optional): 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). Example input: `{"vs_currencies":""}` ### `coingeckopro_get_token_price` Get Token Price by Contract · Read-only 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. Read only: yes. Destructive: no. Idempotent (safe to retry): yes. Inputs: - `asset_platform_id` (`string`, required): CoinGecko asset platform (blockchain) ID, for example ethereum, solana or binance-smart-chain. Valid IDs come from coingeckopro_list_asset_platforms. - `contract_addresses` (`string`, required): Token contract addresses on that platform, comma-separated (up to 515), for example 0x2260fac5e5542a773aa44fbcfedf7c193bc2c599. - `vs_currencies` (`string`, required): 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_change` (`boolean`, optional): Set to true to add the 24-hour price change percentage for each currency. Default false. - `include_24hr_vol` (`boolean`, optional): Set to true to add 24-hour trading volume for each currency. Default false. - `include_last_updated_at` (`boolean`, optional): Set to true to add last_updated_at, the UNIX time of the latest price. Default false. - `include_market_cap` (`boolean`, optional): Set to true to add market capitalization for each currency. Default false. - `precision` (`string`, optional): Number of decimal places for price values, 0 to 18, or full for no rounding. Omit for CoinGecko's default rounding. One of: `full`, `0`, `1`, `2`, `3`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15`, `16`, `17`, `18`. Example input: `{"asset_platform_id":"","contract_addresses":"","vs_currencies":""}` ### `coingeckopro_get_top_gainers_losers` Get Top Gainers and Losers · Read-only 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. Read only: yes. Destructive: no. Idempotent (safe to retry): yes. Inputs: - `vs_currency` (`string`, required): Currency to express prices and market data in, for example usd, eur or btc. Valid values come from coingeckopro_list_supported_vs_currencies. - `duration` (`string`, optional): Period to measure the price change over: 1h, 24h (default), 7d, 14d, 30d, 60d or 1y. One of: `1h`, `24h`, `7d`, `14d`, `30d`, `60d`, `1y`. - `price_change_percentage` (`string`, optional): Extra price-change timeframes to include, comma-separated, from 1h, 24h, 7d, 14d, 30d, 60d, 200d and 1y, for example 1h,30d. - `top_coins` (`string`, optional): 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: `300`, `500`, `1000`, `all`. Example input: `{"vs_currency":""}` ### `coingeckopro_get_trending` Get Trending · Read-only 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. Read only: yes. Destructive: no. Idempotent (safe to retry): yes. Inputs: - `show_max` (`string`, optional): 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. Example input: `{}` ### `coingeckopro_list_asset_platforms` List Asset Platforms · Read-only 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. Read only: yes. Destructive: no. Idempotent (safe to retry): yes. Inputs: - `filter` (`string`, optional): Set to nft to return only platforms that have NFT collections on CoinGecko. One of: `nft`. Example input: `{}` ### `coingeckopro_list_categories` List Categories · Read-only 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. Read only: yes. Destructive: no. Idempotent (safe to retry): yes. Inputs: - `order` (`string`, optional): Sort order. Default market_cap_desc. One of: `market_cap_desc`, `market_cap_asc`, `name_desc`, `name_asc`, `market_cap_change_24h_desc`, `market_cap_change_24h_asc`. Example input: `{}` ### `coingeckopro_list_category_ids` List Category IDs · Read-only 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. Read only: yes. Destructive: no. Idempotent (safe to retry): yes. Inputs: none. Example input: `{}` ### `coingeckopro_list_coins` List Coins · Read-only 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. Read only: yes. Destructive: no. Idempotent (safe to retry): yes. Inputs: - `include_platform` (`boolean`, optional): Set to true to add a platforms object mapping each asset platform ID to the coin's contract address. Default false. - `status` (`string`, optional): 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: `active`, `inactive`. Example input: `{}` ### `coingeckopro_list_coins_markets` List Coins Markets · Read-only 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. Read only: yes. Destructive: no. Idempotent (safe to retry): yes. Inputs: - `vs_currency` (`string`, required): Currency to express prices and market data in, for example usd, eur or btc. Valid values come from coingeckopro_list_supported_vs_currencies. - `category` (`string`, optional): Category ID to limit results to, for example layer-1 or decentralized-finance-defi. Valid IDs come from coingeckopro_list_category_ids. - `ids` (`string`, optional): 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_rehypothecated` (`boolean`, optional): Set to true to include rehypothecated tokens in the ranking and add market_cap_rank_with_rehypothecated. Default false. - `include_tokens` (`string`, optional): 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: `top`, `all`. - `locale` (`string`, optional): Language for localized names. Default en. One of: `ar`, `bg`, `cs`, `da`, `de`, `el`, `en`, `es`, `fi`, `fr`, `he`, `hi`, `hr`, `hu`, `id`, `it`, `ja`, `ko`, `lt`, `nl`, `no`, `pl`, `pt`, `ro`, `ru`, `sk`, `sl`, `sv`, `th`, `tr`, `uk`, `vi`, `zh`, `zh-tw`. - `names` (`string`, optional): Coin names, comma-separated, for example Bitcoin,Ethereum. - `order` (`string`, optional): Sort order. Default market_cap_desc. One of: `market_cap_asc`, `market_cap_desc`, `volume_asc`, `volume_desc`, `id_asc`, `id_desc`. - `page` (`integer`, optional): Page number to return, starting at 1. Omit for page 1. - `per_page` (`integer`, optional): Number of results per page, 1 to 250. Omit for CoinGecko's default of 100. - `precision` (`string`, optional): Number of decimal places for price values, 0 to 18, or full for no rounding. Omit for CoinGecko's default rounding. One of: `full`, `0`, `1`, `2`, `3`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15`, `16`, `17`, `18`. - `price_change_percentage` (`string`, optional): Extra price-change timeframes to include, comma-separated, from 1h, 24h, 7d, 14d, 30d, 200d and 1y, for example 1h,7d. - `sparkline` (`boolean`, optional): Set to true to add 7-day sparkline price data for each coin. Default false. - `symbols` (`string`, optional): Ticker symbols, comma-separated, for example btc,eth. By default only the top-ranked coin per symbol is returned (see include_tokens). Example input: `{"vs_currency":""}` ### `coingeckopro_list_derivatives` List Derivatives Tickers · Read-only 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. Read only: yes. Destructive: no. Idempotent (safe to retry): yes. Inputs: none. Example input: `{}` ### `coingeckopro_list_derivatives_exchanges` List Derivatives Exchanges · Read-only 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. Read only: yes. Destructive: no. Idempotent (safe to retry): yes. Inputs: - `order` (`string`, optional): Sort order. Default open_interest_btc_desc. One of: `name_asc`, `name_desc`, `open_interest_btc_asc`, `open_interest_btc_desc`, `trade_volume_24h_btc_asc`, `trade_volume_24h_btc_desc`. - `page` (`integer`, optional): Page number to return, starting at 1. Omit for page 1. - `per_page` (`integer`, optional): Number of results per page. Omit for CoinGecko's default. Example input: `{}` ### `coingeckopro_list_exchange_ids` List Exchange IDs · Read-only 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. Read only: yes. Destructive: no. Idempotent (safe to retry): yes. Inputs: - `status` (`string`, optional): active (default) for exchanges still listed, or inactive for delisted ones. One of: `active`, `inactive`. Example input: `{}` ### `coingeckopro_list_exchanges` List Exchanges · Read-only 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. Read only: yes. Destructive: no. Idempotent (safe to retry): yes. Inputs: - `page` (`integer`, optional): Page number to return, starting at 1. Omit for page 1. - `per_page` (`integer`, optional): Number of results per page, 1 to 250. Omit for CoinGecko's default of 100. Example input: `{}` ### `coingeckopro_list_insights` List Insights · Read-only 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. Read only: yes. Destructive: no. Idempotent (safe to retry): yes. Inputs: - `coin_id` (`string`, optional): Only return insights about this CoinGecko coin ID, for example solana. Valid IDs come from coingeckopro_list_coins. - `from` (`string`, optional): Only insights posted on or after this date, in YYYY-MM-DD format, for example 2026-10-01. - `page` (`integer`, optional): Page number, 1 to 20. Omit for page 1. - `per_page` (`integer`, optional): Number of insights per page, 1 to 20. Default 10. - `to` (`string`, optional): Only insights posted on or before this date, in YYYY-MM-DD format, for example 2026-10-15. Example input: `{}` ### `coingeckopro_list_new_coins` List New Coins · Read-only 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. Read only: yes. Destructive: no. Idempotent (safe to retry): yes. Inputs: none. Example input: `{}` ### `coingeckopro_list_news` List News · Read-only 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. Read only: yes. Destructive: no. Idempotent (safe to retry): yes. Inputs: - `coin_id` (`string`, optional): Only return articles about this CoinGecko coin ID, for example bitcoin. Valid IDs come from coingeckopro_list_coins. - `language` (`string`, optional): Article language. Default en. One of: `en`, `ru`, `de`, `pl`, `es`, `vi`, `fr`, `pt`, `ar`, `bg`, `cs`, `da`, `el`, `fi`, `he`, `hi`, `hr`, `hu`, `id`, `it`, `ja`, `ko`, `lt`, `nl`, `no`, `ro`, `sk`, `sl`, `sv`, `th`, `tr`, `uk`, `zh`, `zh-tw`. - `page` (`integer`, optional): Page number, 1 to 20. Omit for page 1. - `per_page` (`integer`, optional): Number of articles per page, 1 to 20. Default 10. - `type` (`string`, optional): all (default), news or guides. guides only works together with coin_id. One of: `all`, `news`, `guides`. Example input: `{}` ### `coingeckopro_list_nfts` List NFTs · Read-only 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. Read only: yes. Destructive: no. Idempotent (safe to retry): yes. Inputs: - `order` (`string`, optional): Sort order, for example market_cap_usd_desc or h24_volume_usd_desc. Omit for CoinGecko's default order. One of: `h24_volume_usd_asc`, `h24_volume_usd_desc`, `h24_volume_native_asc`, `h24_volume_native_desc`, `floor_price_native_asc`, `floor_price_native_desc`, `market_cap_native_asc`, `market_cap_native_desc`, `market_cap_usd_asc`, `market_cap_usd_desc`. - `page` (`integer`, optional): Page number to return, starting at 1. Omit for page 1. - `per_page` (`integer`, optional): Number of results per page, 1 to 250. Omit for CoinGecko's default of 100. Example input: `{}` ### `coingeckopro_list_nfts_markets` List NFTs Markets · Read-only 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. Read only: yes. Destructive: no. Idempotent (safe to retry): yes. Inputs: - `asset_platform_id` (`string`, optional): Only list collections on this blockchain, for example ethereum. Valid IDs come from coingeckopro_list_asset_platforms with filter=nft. - `order` (`string`, optional): Sort order. Default market_cap_usd_desc. One of: `h24_volume_native_asc`, `h24_volume_native_desc`, `h24_volume_usd_asc`, `h24_volume_usd_desc`, `market_cap_usd_asc`, `market_cap_usd_desc`. - `page` (`integer`, optional): Page number to return, starting at 1. Omit for page 1. - `per_page` (`integer`, optional): Number of results per page, 1 to 250. Omit for CoinGecko's default of 100. Example input: `{}` ### `coingeckopro_list_onchain_categories` List Onchain Categories · Read-only 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. Read only: yes. Destructive: no. Idempotent (safe to retry): yes. Inputs: - `page` (`integer`, optional): Page number to return, starting at 1. Omit for page 1. - `sort` (`string`, optional): Sort order. Default h6_volume_percentage_desc. One of: `h1_volume_percentage_desc`, `h6_volume_percentage_desc`, `h12_volume_percentage_desc`, `h24_tx_count_desc`, `h24_volume_usd_desc`, `fdv_usd_desc`, `reserve_in_usd_desc`. Example input: `{}` ### `coingeckopro_list_onchain_category_pools` List Onchain Category Pools · Read-only 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. Read only: yes. Destructive: no. Idempotent (safe to retry): yes. Inputs: - `category_id` (`string`, required): GeckoTerminal category ID, for example pump-fun. Valid IDs come from coingeckopro_list_onchain_categories. - `include` (`string`, optional): Related objects to add under included, comma-separated, from base_token, quote_token, dex and network. - `page` (`integer`, optional): Page number to return, starting at 1. Omit for page 1. - `sort` (`string`, optional): Sort order. Default pool_created_at_desc. One of: `m5_trending`, `h1_trending`, `h6_trending`, `h24_trending`, `h24_tx_count_desc`, `h24_volume_usd_desc`, `pool_created_at_desc`, `h24_price_change_percentage_desc`. Example input: `{"category_id":""}` ### `coingeckopro_list_onchain_networks` List Onchain Networks · Read-only 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. Read only: yes. Destructive: no. Idempotent (safe to retry): yes. Inputs: - `page` (`integer`, optional): Page number to return, starting at 1. Omit for page 1. Example input: `{}` ### `coingeckopro_list_onchain_trending_search_pools` List Onchain Trending Search Pools · Read-only 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. Read only: yes. Destructive: no. Idempotent (safe to retry): yes. Inputs: - `include` (`string`, optional): Related objects to add under included, comma-separated, from base_token, quote_token, dex and network. - `pools` (`integer`, optional): Number of pools to return, 1 to 10. Default 4. Example input: `{}` ### `coingeckopro_list_rwas` List RWAs · Read-only 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. Read only: yes. Destructive: no. Idempotent (safe to retry): yes. Inputs: - `asset_type` (`string`, optional): Only list RWAs of this type: stock, commodity or etf. Omit for all. One of: `stock`, `commodity`, `etf`. Example input: `{}` ### `coingeckopro_list_supported_vs_currencies` List Supported VS Currencies · Read-only 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. Read only: yes. Destructive: no. Idempotent (safe to retry): yes. Inputs: none. Example input: `{}` ### `coingeckopro_ping` Ping · Read-only 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. Read only: yes. Destructive: no. Idempotent (safe to retry): yes. Inputs: none. Example input: `{}` ### `coingeckopro_search` Search · Read-only 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. Read only: yes. Destructive: no. Idempotent (safe to retry): yes. Inputs: - `query` (`string`, required): Text to search for: a coin, exchange, category or NFT name or symbol, for example solana or btc. Example input: `{"query":""}` ### `coingeckopro_search_onchain_pools` Search Onchain Pools · Read-only 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. Read only: yes. Destructive: no. Idempotent (safe to retry): yes. Inputs: - `include` (`string`, optional): Related objects to add under included, comma-separated, from base_token, quote_token and dex. - `network` (`string`, optional): Only search pools on this GeckoTerminal network ID, for example eth, solana or base. Valid IDs come from coingeckopro_list_onchain_networks. - `page` (`integer`, optional): Page number, starting at 1. Pages beyond 10 need an Analyst plan or above. - `query` (`string`, optional): Pool contract address, token name, token symbol or token contract address, for example weth. Example input: `{}` ## Related Other Accounting & Finance connectors ([all 45](/agentkit/connectors/?category=accounting-finance)): - [QuickBooks](/agentkit/connectors/quickbooks/): Scalekit connector, OAuth, 117 tools - [Xero](/agentkit/connectors/xero/): Scalekit connector, OAuth, 94 tools - [Stripe](/agentkit/connectors/stripe/): Scalekit connector, Access token, 178 tools --- ## More Scalekit documentation | Resource | What it contains | When to use it | |----------|-----------------|----------------| | [/llms.txt](/llms.txt) | Structured index with routing hints per product area | Start here — find which documentation set covers your topic before loading full content | | [/llms-full.txt](/llms-full.txt) | Complete documentation for all Scalekit products in one file | Use when you need exhaustive context across multiple products or when the topic spans several areas | | [sitemap-0.xml](https://docs.scalekit.com/sitemap-0.xml) | Full URL list of every documentation page | Use to discover specific page URLs you can fetch for targeted, page-level answers |