# CoinGecko > CoinGecko API — 36 operations. MCP endpoint: https://coingecko.mcp.junct.dev/mcp Domain: analytics Auth: none ## Tools ## Read ### get_simple_supported_vs_currencies Get list of supported_vs_currencies. — Cache / Update Frequency: every 60 seconds _No parameters required._ > Call this first to discover valid IDs/slugs. ### get_asset_platforms List all asset platforms (Blockchain networks) — List all asset platforms **Parameters:** - `filter` (string, optional): apply relevant filters to results valid values: "nft" (asset_platform nft-support) > Call this first to discover valid IDs/slugs. ### get_coins_categories List all categories with market data — List all categories with market data Cache / Update Frequency: every 5 minutes **Parameters:** - `order` (string, optional): valid values: market_cap_desc (default), market_cap_asc, name_desc, name_asc, market_cap_change_24h_desc and market_cap_change_24h_asc > Call this first to discover valid IDs/slugs. ### get_exchanges List all exchanges (Active with trading volumes) — List all exchanges Cache / Update Frequency: every 60 seconds **Parameters:** - `per_page` (string, optional): Valid values: 1...250 Total results per page Default value:: 100 - `page` (string, optional): page through results > Call this first to discover valid IDs/slugs. ### get_derivatives List all derivative tickers — List all derivative tickers.
Note: 'open_interest' and 'volume_24h' data are in USD Cache / Update Frequency: every 30 seconds _No parameters required._ > Call this first to discover valid IDs/slugs. ### get_derivatives_exchanges List all derivative exchanges — List all derivative exchanges. Cache / Update Frequency: every 60 seconds **Parameters:** - `order` (string, optional): order results using following params name_asc，name_desc，open_interest_btc_asc，open_interest_btc_desc，trade_volume_24h_btc_asc，trade_volume_24h_btc_desc - `per_page` (string, optional): Total results per page - `page` (string, optional): Page through results > Call this first to discover valid IDs/slugs. ### get_exchange_rates Get BTC-to-Currency exchange rates — Get BTC-to-Currency exchange rates Cache / Update Frequency: every 60 seconds _No parameters required._ > Call this first to discover valid IDs/slugs. ### get_ping Check API server status — Check API server status _No parameters required._ ### get_simple_price Get the current price of any cryptocurrencies in any other supported currencies that you need. — Note: to check if a price is stale, please flag `include_last_updated_at=true` to get the latest updated time. You may also flag `include_24hr_change=true` to check if it returns 'null' value. Cache / Update Frequency: every 60 seconds (every 30 seconds for Pro API) **Parameters:** - `ids` (string, required): id of coins, comma-separated if querying more than 1 coin *refers to `coins/list` - `vs_currencies` (string, required): vs_currency of coins, comma-separated if querying more than 1 vs_currency *refers to `simple/supported_vs_currencies` - `include_market_cap` (string, optional): true/false to include market_cap, default: false - `include_24hr_vol` (string, optional): true/false to include 24hr_vol, default: false - `include_24hr_change` (string, optional): true/false to include 24hr_change, default: false - `include_last_updated_at` (string, optional): true/false to include last_updated_at of price, default: false - `precision` (string, optional): full or any value between 0 - 18 to specify decimal place for currency price value ### get_simple_token_price_id Get current price of tokens (using contract addresses) for a given platform in any other currency that you need. — This endpoint allows you to query a token price by using contract address. It returns the global average price that is aggregated across all active exchanges on CoinGecko. It does not return the price of a specific network, you may cross-check the price on CoinGecko.com. Learn more about our price methodology here. Cache / Update Frequency: every 60 seconds (every 30 seconds for Pro **Parameters:** - `id` (string, required): The id of the platform issuing tokens (See asset_platforms endpoint for list of options) - `contract_addresses` (string, required): The contract address of tokens, comma separated - `vs_currencies` (string, required): vs_currency of coins, comma-separated if querying more than 1 vs_currency *refers to `simple/supported_vs_currencies` - `include_market_cap` (string, optional): true/false to include market_cap, default: false - `include_24hr_vol` (string, optional): true/false to include 24hr_vol, default: false - `include_24hr_change` (string, optional): true/false to include 24hr_change, default: false - `include_last_updated_at` (string, optional): true/false to include last_updated_at of price, default: false - `precision` (string, optional): full or any value between 0 - 18 to specify decimal place for currency price value ### get_coins_list List all supported coins id, name and symbol (no pagination required) —
  • All the coins that show up on this /coins/list endpoint are Active coins that listed by CoinGecko team on CoinGecko.com
  • If a coin is inactive or deactivated, it will be removed from /coins/list
    • Cache / Update Frequency: every 5 minutes **Parameters:** - `include_platform` (string, optional): flag to include platform contract addresses (eg. 0x.... for Ethereum based tokens). valid values: true, false ### get_coins_markets List all supported coins price, market cap, volume, and market related data — Use this to obtain all the coins market data (price, market cap, volume), per page.
    Note: when both 'category' and 'ids' parameters are supplied, the 'category' parameter takes precedence over the 'ids' parameter. Cache / Update Frequency: every 45 seconds **Parameters:** - `vs_currency` (string, required): The target currency of market data (usd, eur, jpy, etc.) - `ids` (string, optional): The ids of the coin, comma separated crytocurrency symbols (base). refers to `/coins/list`. - `category` (string, optional): filter by coin category. Refer to /coin/categories/list - `order` (string, optional): valid values: market_cap_asc, market_cap_desc, volume_asc, volume_desc, id_asc, id_desc sort results by field. - `per_page` (string, optional): valid values: 1..250 Total results per page - `page` (string, optional): Page through results - `sparkline` (string, optional): Include sparkline 7 days data (eg. true, false) - `price_change_percentage` (string, optional): Include price change percentage in 1h, 24h, 7d, 14d, 30d, 200d, 1y (eg. '`1h,24h,7d`' comma-separated, invalid values will be discarded) - `locale` (string, optional): valid values: 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 - `precision` (string, optional): full or any value between 0 - 18 to specify decimal place for currency price value ### get_coins_id Get current data (name, price, market, ... including exchange tickers) for a coin — Get current data (name, price, market, ... including exchange tickers) for a coin.

    **IMPORTANT**: Ticker object is limited to 100 items, to get more tickers, use `/coins/{id}/tickers` Ticker `is_stale` is true when ticker that has not been updated/unchanged from the exchange for more than 8 hours. Ticker `is_anomaly` is true if ticker's price is outliered by our system. You are responsible for managing how you want to display these information (e.g. footnote, different background, change opacity, hi **Parameters:** - `id` (string, required): pass the coin id (can be obtained from /coins) eg. bitcoin - `localization` (string, optional): Include all localized languages in response (true/false) [default: true] - `tickers` (string, optional): Include tickers data (true/false) [default: true] - `market_data` (string, optional): Include market_data (true/false) [default: true] - `community_data` (string, optional): Include community_data data (true/false) [default: true] - `developer_data` (string, optional): Include developer_data data (true/false) [default: true] - `sparkline` (string, optional): Include sparkline 7 days data (eg. true, false) [default: false] ### get_coins_id_tickers Get coin tickers (paginated to 100 items) — Get coin tickers (paginated to 100 items)

    **IMPORTANT**: Ticker `is_stale` is true when ticker that has not been updated/unchanged from the exchange for more than 8 hours. Ticker `is_anomaly` is true if ticker's price is outliered by our system. You are responsible for managing how you want to display these information (e.g. footnote, different background, change opacity, hide) Dictionary:
  • last: latest unconverted price in the respective pair target currency
  • volume: unconverted 24h trading volu **Parameters:** - `id` (string, required): pass the coin id (can be obtained from /coins/list) eg. bitcoin - `exchange_ids` (string, optional): filter results by exchange_ids (ref: v3/exchanges/list) - `include_exchange_logo` (string, optional): flag to show exchange_logo. valid values: true, false - `page` (string, optional): Page through results - `order` (string, optional): valid values: trust_score_desc (default), trust_score_asc and volume_desc - `depth` (string, optional): flag to show 2% orderbook depth. i.e., cost_to_move_up_usd and cost_to_move_down_usd. valid values: true, false ### get_coins_id_history Get historical data (price, market cap, 24hr volume, ..) at a given date for a coin. — Get historical data (price, market cap, 24hr volume, ..) at a given date for a coin. The data returned is at 00:00:00 UTC. The last completed UTC day (00:00) is available 35 minutes after midnight on the next UTC day (00:35). **Parameters:** - `id` (string, required): pass the coin id (can be obtained from /coins) eg. bitcoin - `date` (string, required): The date of data snapshot in dd-mm-yyyy eg. 30-12-2022 - `localization` (string, optional): Set to false to exclude localized languages in response ### get_coins_id_market_chart Get historical market data include price, market cap, and 24h volume (granularity auto) — Get historical market data include price, market cap, and 24h volume (granularity auto) Data granularity is automatic (cannot be adjusted) Cache based on days range:

    The last completed UTC day (00:00) i **Parameters:** - `id` (string, required): pass the coin id (can be obtained from /coins) eg. bitcoin - `vs_currency` (string, required): The target currency of market data (usd, eur, jpy, etc.) - `days` (string, required): Data up to number of days ago (eg. 1,14,30,max) - `interval` (string, optional): Data interval. Possible value: daily - `precision` (string, optional): full or any value between 0 - 18 to specify decimal place for currency price value ### get_coins_id_market_chart_range Get historical market data include price, market cap, and 24h volume within a range of timestamp (granularity auto) — Get historical market data include price, market cap, and 24h volume (granularity auto) Data granularity is automatic (cannot be adjusted)

    Cache / Update Frequency: every 5 minutes. The last completed UTC day (00:00) is available 35 minutes after midnight on the next UTC day (00:35). **Parameters:** - `id` (string, required): pass the coin id (can be obtained from /coins) eg. bitcoin - `vs_currency` (string, required): The target currency of market data (usd, eur, jpy, etc.) - `from` (string, required): From date in UNIX Timestamp (eg. 1392577232) - `to` (string, required): To date in UNIX Timestamp (eg. 1422577232) - `precision` (string, optional): full or any value between 0 - 18 to specify decimal place for currency price value ### get_coins_id_contract_contract_address Get coin info from contract address — Get coin info from contract address Cache / Update Frequency: every 60 seconds **Parameters:** - `id` (string, required): Asset platform (See asset_platforms endpoint for list of options) - `contract_address` (string, required): Token's contract address ### get_coins_id_contract_contract_address_market_chart Get historical market data include price, market cap, and 24h volume (granularity auto) from a contract address — Get historical market data include price, market cap, and 24h volume (granularity auto) Data granularity is automatic (cannot be adjusted) Cache based on days range:

    The last co **Parameters:** - `id` (string, required): The id of the platform issuing tokens (See asset_platforms endpoint for list of options) - `contract_address` (string, required): Token's contract address - `vs_currency` (string, required): The target currency of market data (usd, eur, jpy, etc.) - `days` (string, required): Data up to number of days ago (eg. 1,14,30,max) - `precision` (string, optional): full or any value between 0 - 18 to specify decimal place for currency price value ### get_coins_id_contract_contract_address_market_chart_range Get historical market data include price, market cap, and 24h volume within a range of timestamp (granularity auto) from a contract address — Get historical market data include price, market cap, and 24h volume (granularity auto) Data granularity is automatic (cannot be adjusted)

    Cache / Update Frequency: every 5 minutes. The last completed UTC day (00:00) is available 35 minutes after midnight on the next UTC d **Parameters:** - `id` (string, required): The id of the platform issuing tokens (See asset_platforms endpoint for list of options) - `contract_address` (string, required): Token's contract address - `vs_currency` (string, required): The target currency of market data (usd, eur, jpy, etc.) - `from` (string, required): From date in UNIX Timestamp (eg. 1392577232) - `to` (string, required): To date in UNIX Timestamp (eg. 1422577232) - `precision` (string, optional): full or any value between 0 - 18 to specify decimal place for currency price value ### get_coins_id_ohlc Get coin's OHLC — Candle's body - data granularity is automatic (cannot be adjusted for public api users):

    Daily candle interval parameter is available for paid plan users only (Analyst/Lite/Pro/Enterprise), use interval=daily parameter in your request:

    Cache / Update Frequency: every 30 minutes The last completed UTC day (00:00) is available 35 minutes after midnight on the next UTC day (00:35). **Parameters:** - `id` (string, required): pass the coin id (can be obtained from /coins/list) eg. bitcoin - `vs_currency` (string, required): The target currency of market data (usd, eur, jpy, etc.) - `days` (string, required): Data up to number of days ago (1/7/14/30/90/180/365/max) - `precision` (string, optional): full or any value between 0 - 18 to specify decimal place for currency price value ### get_coins_categories_list List all categories — List all categories Cache / Update Frequency: every 5 minutes _No parameters required._ ### get_exchanges_list List all supported markets id and name (no pagination required) — Use this to obtain all the markets' id in order to make API calls Cache / Update Frequency: every 5 minutes _No parameters required._ ### get_exchanges_id Get exchange volume in BTC and top 100 tickers only — Get exchange volume in BTC and tickers.
    For derivatives (e.g. bitmex, binance_futures), please use `/derivatives/exchange/{id}` endpoint.

    **IMPORTANT**: Ticker object is limited to 100 items, to get more tickers, use `/exchanges/{id}/tickers` Ticker `is_stale` is true when ticker that has not been updated/unchanged from the exchange for more than 8 hours. Ticker `is_anomaly` is true if ticker's price is outliered by our system. You are responsible for managing how you want to display these information (e.g. footnote, differen **Parameters:** - `id` (string, required): pass the exchange id (can be obtained from /exchanges/list) eg. binance ### get_exchanges_id_tickers Get exchange tickers (paginated, 100 tickers per page) — Get exchange tickers (paginated)

    **IMPORTANT**: Ticker `is_stale` is true when ticker that has not been updated/unchanged from the exchange for more than 8 hours. Ticker `is_anomaly` is true if ticker's price is outliered by our system. You are responsible for managing how you want to display these information (e.g. footnote, different background, change opacity, hide) Dictionary:
  • last: latest unconverted price in the respective pair target currency
  • volume: unconverted 24h trading **Parameters:** - `id` (string, required): pass the exchange id (can be obtained from /exchanges/list) eg. binance - `coin_ids` (string, optional): filter tickers by coin_ids (ref: v3/coins/list) - `include_exchange_logo` (string, optional): flag to show exchange_logo. valid values: true, false - `page` (string, optional): Page through results - `depth` (string, optional): flag to show 2% orderbook depth. i.e., cost_to_move_up_usd and cost_to_move_down_usd. valid values: true, false - `order` (string, optional): valid values: trust_score_desc (default), trust_score_asc and volume_desc ### get_derivatives_exchanges_id show derivative exchange data — show derivative exchange data Dictionary:
  • last: latest unconverted price in the respective pair target currency
  • volume: unconverted 24h trading volume in the respective pair target currency
  • converted_last: latest converted price in BTC, ETH, and USD
  • converted_volume: converted 24h trading volume in BTC, ETH, and USD
    • Cache / Update Frequency: every 30 seconds **Parameters:** - `id` (string, required): pass the exchange id (can be obtained from derivatives/exchanges/list) eg. bitmex - `include_tickers` (string, optional): ['all', 'unexpired'] - expired to show unexpired tickers, all to list all tickers, leave blank to omit tickers data in response ### get_derivatives_exchanges_list List all derivative exchanges name and identifier — List all derivative exchanges name and identifier. Cache / Update Frequency: every 5 minutes _No parameters required._ ### get_exchanges_id_volume_chart Get 24 hour rolling trading volume data (in BTC) for a given exchange. — Get 24 hour rolling trading volume data (in BTC) for a given exchange. Data granularity is automatic (cannot be adjusted)

    Note: exclusive endpoint is available for paid users to query more than 1 year of historical data

    Cache / Update Frequency: every 60 seconds **Parameters:** - `id` (string, required): pass the exchange id (can be obtained from /exchanges/list) eg. binance - `days` (string, required): Data up to number of days ago (1/7/14/30/90/180/365) ### get_nfts_list List all supported NFT ids, paginated by 100 items per page, paginated to 100 items — Use this to obtain all the NFT ids in order to make API calls, paginated to 100 items. Cache / Update Frequency: every 5 minutes **Parameters:** - `order` (string, optional): valid values: 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 - `asset_platform_id` (string, optional): The id of the platform issuing tokens (See asset_platforms endpoint for list of options) - `per_page` (string, optional): Valid values: 1..250
    Total results per page - `page` (string, optional): Page through results ### get_nfts_id Get current data (name, price_floor, volume_24h ...) for an NFT collection — Get current data (name, price_floor, volume_24h ...) for an NFT collection. native_currency (string) is only a representative of the currency. Cache / Update Frequency: every 60 seconds **Parameters:** - `id` (string, required): id of nft collection (can be obtained from /nfts/list) ### get_nfts_asset_platform_id_contract_contract_address Get current data (name, price_floor, volume_24h ...) for an NFT collection. — Get current data (name, price_floor, volume_24h ...) for an NFT collection. *Solana NFT & Art Blocks are not supported for this endpoint, please use `/nfts/{id}` endpoint instead. Cache / Update Frequency: every 60 seconds **Parameters:** - `asset_platform_id` (string, required): The id of the platform issuing tokens (See asset_platforms endpoint for list of options, use filter=nft param) - `contract_address` (string, required): The contract_address of the nft collection (/nfts/list for list of nft collection with metadata) ### get_search Search for coins, categories and markets on CoinGecko — Search for coins, categories and markets listed on CoinGecko ordered by largest Market Cap first. Cache / Update Frequency: every 15 minutes Returns: { coins: unknown[], exchanges: unknown[], categories: unknown[] }. **Parameters:** - `query` (string, required): Search string ### get_search_trending Get trending search coins (Top-7) on CoinGecko in the last 24 hours — * Top-7 trending coins on CoinGecko as searched by users in the last 24 hours (Ordered by most popular first). * Top-5 trending NFTs on CoinGecko based on the highest trading volume in the last 24 hours Cache / Update Frequency: every 10 minutes _No parameters required._ ### get_global Get cryptocurrency global data — Get cryptocurrency global data Cache / Update Frequency: every 10 minutes _No parameters required._ ### get_global_decentralized_finance_defi Get cryptocurrency global decentralized finance(defi) data — Get Top 100 Cryptocurrency Global Eecentralized Finance(defi) data Cache / Update Frequency: every 60 minutes _No parameters required._ ### get_companies_public_treasury_coin_id Get public companies data — Get public companies bitcoin or ethereum holdings (Ordered by total holdings descending) **Parameters:** - `coin_id` (string, optional): bitcoin or ethereum ## Usage Connect to this MCP server at `https://coingecko.mcp.junct.dev/mcp`. All tools are callable via the MCP protocol. Call `get_simple_supported_vs_currencies` first to discover valid identifiers required by other tools.