Can I use CoinGecko as a CLI?

Yes. KosmoKrator exposes a CoinGecko CLI through kosmo integrations:call and the provider shortcut command. Commands can return JSON for scripts, CI, and coding agents.

Can I expose CoinGecko through MCP?

Yes. The KosmoKrator MCP gateway can expose selected CoinGecko tools to clients such as Claude Code, Cursor, Codex, and other MCP-compatible tools.

Where are CoinGecko credentials stored?

CoinGecko credentials are configured in KosmoKrator's local integration settings and reused by CLI, Lua, and MCP gateway surfaces.

Can I deny write access for CoinGecko MCP tools?

Yes. Start the gateway with --write=deny for read-only clients, or use ask/allow only for trusted workspaces.

data

CoinGecko CLI for AI Agents

Use the CoinGecko CLI from KosmoKrator to call CoinGecko tools headlessly, return JSON, inspect schemas, and automate workflows from coding agents, scripts, and CI.

CoinGecko CLI Setup

CoinGecko can be configured headlessly with `kosmokrator integrations:configure coingecko`.

Install, configure, and verify

# Install KosmoKrator first if it is not available on PATH.
curl -fsSL https://raw.githubusercontent.com/OpenCompanyApp/kosmokrator/main/install.sh | bash

# Configure and verify this integration.
kosmokrator integrations:configure coingecko --enable --read allow --write ask --json
kosmokrator integrations:doctor coingecko --json
kosmokrator integrations:status --json

Credentials

Authentication type: API key api_key. Configure credentials once, then reuse the same stored profile from scripts, coding CLIs, Lua, and MCP.

Key	Env var	Type	Required	Label
`api_key`	`COINGECKO_API_KEY`	Secret `secret`	no	API Key

Command Patterns

The generic command is stable across every integration. The provider shortcut is shorter for humans.

Generic CLI call

kosmo integrations:call coingecko.coingecko_api_get '{"path":"example_path","params":"example_params"}' --json

Provider shortcut

kosmo integrations:coingecko coingecko_api_get '{"path":"example_path","params":"example_params"}' --json

Discovery

These commands return structured output for coding agents that need to inspect capabilities before choosing a function.

Discovery commands

kosmo integrations:docs coingecko --json
kosmo integrations:docs coingecko.coingecko_api_get --json
kosmo integrations:schema coingecko.coingecko_api_get --json
kosmo integrations:search "CoinGecko" --json
kosmo integrations:list --json

Automation Contexts

The same configured command surface works in these environments. The command does not change unless the host wrapper, credentials, or permissions change.

CI Run integration calls from CI jobs with JSON output, explicit credentials, and predictable exit status. Cron Jobs Schedule repeatable integration workflows from cron while keeping credentials in KosmoKrator config. Shell Scripts Call integration functions from shell scripts with stable JSON input and output. Headless Automation Use KosmoKrator as a non-interactive integration runtime for local automations and wrappers. Coding Agents Let coding agents discover schemas and execute integration functions through CLI commands or MCP.

CLI Functions

Every function below can be called headlessly. Commands are highlighted, copyable, and scroll horizontally when payloads are long.

`coingecko.coingecko_api_get`

Call any CoinGecko API v3 GET path not covered by a first-class tool, such as /derivatives or /nfts/list.

Read read

Parameters: path, params

Generic call

kosmo integrations:call coingecko.coingecko_api_get '{"path":"example_path","params":"example_params"}' --json

Shortcut

kosmo integrations:coingecko coingecko_api_get '{"path":"example_path","params":"example_params"}' --json

`coingecko.coingecko_categories_market_data`

List CoinGecko categories with market cap, volume, and top coin data.

Read read

Parameters: params

Generic call

kosmo integrations:call coingecko.coingecko_categories_market_data '{"params":"example_params"}' --json

Shortcut

kosmo integrations:coingecko coingecko_categories_market_data '{"params":"example_params"}' --json

`coingecko.coingecko_coin_history_date`

Get historical coin data for a calendar date in dd-mm-yyyy format.

Read read

Parameters: id, date, params

Generic call

kosmo integrations:call coingecko.coingecko_coin_history_date '{"id":"example_id","date":"example_date","params":"example_params"}' --json

Shortcut

kosmo integrations:coingecko coingecko_coin_history_date '{"id":"example_id","date":"example_date","params":"example_params"}' --json

`coingecko.coingecko_coin_tickers`

Get centralized and decentralized exchange tickers for a CoinGecko coin ID.

Read read

Parameters: id, params

Generic call

kosmo integrations:call coingecko.coingecko_coin_tickers '{"id":"example_id","params":"example_params"}' --json

Shortcut

kosmo integrations:coingecko coingecko_coin_tickers '{"id":"example_id","params":"example_params"}' --json

`coingecko.coingecko_exchange_rates`

Get BTC-to-currency exchange rates for fiat and crypto units.

Read read

Parameters: none

Generic call

kosmo integrations:call coingecko.coingecko_exchange_rates '{}' --json

Shortcut

kosmo integrations:coingecko coingecko_exchange_rates '{}' --json

`coingecko.coingecko_exchange_volume_chart`

Get historical exchange volume chart data in BTC.

Read read

Parameters: id, days

Generic call

kosmo integrations:call coingecko.coingecko_exchange_volume_chart '{"id":"example_id","days":"example_days"}' --json

Shortcut

kosmo integrations:coingecko coingecko_exchange_volume_chart '{"id":"example_id","days":"example_days"}' --json

`coingecko.coingecko_get_exchange`

Get exchange profile data, volume, and tickers by CoinGecko exchange ID.

Read read

Parameters: id

Generic call

kosmo integrations:call coingecko.coingecko_get_exchange '{"id":"example_id"}' --json

Shortcut

kosmo integrations:coingecko coingecko_get_exchange '{"id":"example_id"}' --json

`coingecko.coingecko_get_exchange_tickers`

Get market tickers for a CoinGecko exchange ID.

Read read

Parameters: id, params

Generic call

kosmo integrations:call coingecko.coingecko_get_exchange_tickers '{"id":"example_id","params":"example_params"}' --json

Shortcut

kosmo integrations:coingecko coingecko_get_exchange_tickers '{"id":"example_id","params":"example_params"}' --json

`coingecko.coingecko_global`

Get overall crypto market statistics — total market cap, BTC dominance, active cryptocurrencies, trading volume, and more.

Read read

Parameters: none

Generic call

kosmo integrations:call coingecko.coingecko_global '{}' --json

Shortcut

kosmo integrations:coingecko coingecko_global '{}' --json

`coingecko.coingecko_global_defi`

Get global DeFi market cap, volume, dominance, and related aggregate metrics.

Read read

Parameters: none

Generic call

kosmo integrations:call coingecko.coingecko_global_defi '{}' --json

Shortcut

kosmo integrations:coingecko coingecko_global_defi '{}' --json

`coingecko.coingecko_history`

Get historical price, volume, and market cap chart data for a cryptocurrency over a time period. Returns timestamped data points with summary statistics.

Read read

Parameters: id, currency, days

Generic call

kosmo integrations:call coingecko.coingecko_history '{"id":"example_id","currency":"example_currency","days":"example_days"}' --json

Shortcut

kosmo integrations:coingecko coingecko_history '{"id":"example_id","currency":"example_currency","days":"example_days"}' --json

`coingecko.coingecko_info`

Get a full coin profile — description, categories, links (website, whitepaper, social), and current market data snapshot. Use `coingecko_search_coins` first to find the coin ID.

Read read

Parameters: id

Generic call

kosmo integrations:call coingecko.coingecko_info '{"id":"example_id"}' --json

Shortcut

kosmo integrations:coingecko coingecko_info '{"id":"example_id"}' --json

`coingecko.coingecko_list_asset_platforms`

List asset platform IDs and chain metadata used by token-price and token-list endpoints.

Read read

Parameters: params

Generic call

kosmo integrations:call coingecko.coingecko_list_asset_platforms '{"params":"example_params"}' --json

Shortcut

kosmo integrations:coingecko coingecko_list_asset_platforms '{"params":"example_params"}' --json

`coingecko.coingecko_list_categories`

List CoinGecko category IDs for filtering market data.

Read read

Parameters: none

Generic call

kosmo integrations:call coingecko.coingecko_list_categories '{}' --json

Shortcut

kosmo integrations:coingecko coingecko_list_categories '{}' --json

`coingecko.coingecko_list_coins`

List supported CoinGecko coin IDs, symbols, names, and optional asset-platform contract addresses.

Read read

Parameters: params

Generic call

kosmo integrations:call coingecko.coingecko_list_coins '{"params":"example_params"}' --json

Shortcut

kosmo integrations:coingecko coingecko_list_coins '{"params":"example_params"}' --json

`coingecko.coingecko_list_entities`

List public companies and governments supported by CoinGecko public treasury endpoints.

Read read

Parameters: none

Generic call

kosmo integrations:call coingecko.coingecko_list_entities '{}' --json

Shortcut

kosmo integrations:coingecko coingecko_list_entities '{}' --json

`coingecko.coingecko_list_exchange_ids`

List exchange IDs and names for exchange-specific tools.

Read read

Parameters: none

Generic call

kosmo integrations:call coingecko.coingecko_list_exchange_ids '{}' --json

Shortcut

kosmo integrations:coingecko coingecko_list_exchange_ids '{}' --json

`coingecko.coingecko_list_exchanges`

List active exchanges with country, trust score, and 24-hour BTC volume data.

Read read

Parameters: params

Generic call

kosmo integrations:call coingecko.coingecko_list_exchanges '{"params":"example_params"}' --json

Shortcut

kosmo integrations:coingecko coingecko_list_exchanges '{"params":"example_params"}' --json

`coingecko.coingecko_markets`

Get top cryptocurrencies ranked by market cap with full market data (price, volume, ATH, supply, price changes). Supports filtering by category or specific coin IDs.

Read read

Parameters: ids, currency, category, per_page, page, price_change_percentage

Generic call

kosmo integrations:call coingecko.coingecko_markets '{"ids":"example_ids","currency":"example_currency","category":"example_category","per_page":"example_per_page","page":"example_page","price_change_percentage":"example_price_change_percentage"}' --json

Shortcut

kosmo integrations:coingecko coingecko_markets '{"ids":"example_ids","currency":"example_currency","category":"example_category","per_page":"example_per_page","page":"example_page","price_change_percentage":"example_price_change_percentage"}' --json

`coingecko.coingecko_new_coins`

List the latest coins recently added to CoinGecko.

Read read

Parameters: none

Generic call

kosmo integrations:call coingecko.coingecko_new_coins '{}' --json

Shortcut

kosmo integrations:coingecko coingecko_new_coins '{}' --json

`coingecko.coingecko_ohlc`

Get OHLC (Open/High/Low/Close) candlestick data for a cryptocurrency for technical analysis.

Read read

Parameters: id, currency, days

Generic call

kosmo integrations:call coingecko.coingecko_ohlc '{"id":"example_id","currency":"example_currency","days":"example_days"}' --json

Shortcut

kosmo integrations:coingecko coingecko_ohlc '{"id":"example_id","currency":"example_currency","days":"example_days"}' --json

`coingecko.coingecko_price`

Get current price for one or more cryptocurrencies (by CoinGecko ID). Includes 24h change, volume, and market cap. Use `coingecko_search_coins` first to find coin IDs.

Read read

Parameters: ids, currencies

Generic call

kosmo integrations:call coingecko.coingecko_price '{"ids":"example_ids","currencies":"example_currencies"}' --json

Shortcut

kosmo integrations:coingecko coingecko_price '{"ids":"example_ids","currencies":"example_currencies"}' --json

`coingecko.coingecko_public_treasury_by_coin`

Get public company or government crypto treasury holdings by CoinGecko coin ID.

Read read

Parameters: entity, coin_id, params

Generic call

kosmo integrations:call coingecko.coingecko_public_treasury_by_coin '{"entity":"example_entity","coin_id":"example_coin_id","params":"example_params"}' --json

Shortcut

kosmo integrations:coingecko coingecko_public_treasury_by_coin '{"entity":"example_entity","coin_id":"example_coin_id","params":"example_params"}' --json

`coingecko.coingecko_public_treasury_entity`

Get public treasury holdings for a public company or government entity ID.

Read read

Parameters: entity_id, params

Generic call

kosmo integrations:call coingecko.coingecko_public_treasury_entity '{"entity_id":"example_entity_id","params":"example_params"}' --json

Shortcut

kosmo integrations:coingecko coingecko_public_treasury_entity '{"entity_id":"example_entity_id","params":"example_params"}' --json

`coingecko.coingecko_search_coins`

Find cryptocurrencies by name or ticker symbol (e.g. "bitcoin", "ETH", "solana"). Returns matching coin IDs which are needed for other CoinGecko tools.

Read read

Parameters: query

Generic call

kosmo integrations:call coingecko.coingecko_search_coins '{"query":"example_query"}' --json

Shortcut

kosmo integrations:coingecko coingecko_search_coins '{"query":"example_query"}' --json

`coingecko.coingecko_simple_token_price`

Get token prices by asset platform ID and token contract address.

Read read

Parameters: asset_platform_id, contract_addresses, currencies

Generic call

kosmo integrations:call coingecko.coingecko_simple_token_price '{"asset_platform_id":"example_asset_platform_id","contract_addresses":"example_contract_addresses","currencies":"example_currencies"}' --json

Shortcut

kosmo integrations:coingecko coingecko_simple_token_price '{"asset_platform_id":"example_asset_platform_id","contract_addresses":"example_contract_addresses","currencies":"example_currencies"}' --json

`coingecko.coingecko_token_list`

Get the token list for an asset platform, such as ethereum or polygon-pos.

Read read

Parameters: asset_platform_id

Generic call

kosmo integrations:call coingecko.coingecko_token_list '{"asset_platform_id":"example_asset_platform_id"}' --json

Shortcut

kosmo integrations:coingecko coingecko_token_list '{"asset_platform_id":"example_asset_platform_id"}' --json

`coingecko.coingecko_top_gainers_losers`

Get top gainers and losers for a target currency and time duration.

Read read

Parameters: currency, params

Generic call

kosmo integrations:call coingecko.coingecko_top_gainers_losers '{"currency":"example_currency","params":"example_params"}' --json

Shortcut

kosmo integrations:coingecko coingecko_top_gainers_losers '{"currency":"example_currency","params":"example_params"}' --json

`coingecko.coingecko_trending`

Get the top trending cryptocurrencies in the last 24 hours based on search activity on CoinGecko.

Read read

Parameters: none

Generic call

kosmo integrations:call coingecko.coingecko_trending '{}' --json

Shortcut

kosmo integrations:coingecko coingecko_trending '{}' --json

Function Schemas

Use these parameter tables when building CLI payloads without calling integrations:schema first.

coingecko.coingecko_api_get 2 parameters

Schema command

kosmo integrations:schema coingecko.coingecko_api_get --json

Parameter	Type	Required	Description
`path`	string	yes	CoinGecko API path, such as /derivatives or /nfts/list.
`params`	object	no	Query parameters.

coingecko.coingecko_categories_market_data 1 parameters

Schema command

kosmo integrations:schema coingecko.coingecko_categories_market_data --json

Parameter	Type	Required	Description
`params`	object	no	Optional query parameters such as order.

coingecko.coingecko_coin_history_date 3 parameters

Schema command

kosmo integrations:schema coingecko.coingecko_coin_history_date --json

Parameter	Type	Required	Description
`id`	string	yes	CoinGecko coin ID.
`date`	string	yes	Date in dd-mm-yyyy format.
`params`	object	no	Optional query parameters such as localization.

coingecko.coingecko_coin_tickers 2 parameters

Schema command

kosmo integrations:schema coingecko.coingecko_coin_tickers --json

Parameter	Type	Required	Description
`id`	string	yes	CoinGecko coin ID.
`params`	object	no	Optional query parameters such as exchange_ids, page, depth, order.

coingecko.coingecko_exchange_rates 0 parameters

Schema command

kosmo integrations:schema coingecko.coingecko_exchange_rates --json

Parameter	Type	Required	Description
No parameters.

coingecko.coingecko_exchange_volume_chart 2 parameters

Schema command

kosmo integrations:schema coingecko.coingecko_exchange_volume_chart --json

Parameter	Type	Required	Description
`id`	string	yes	CoinGecko exchange ID.
`days`	string	no	Number of days, default 30.

coingecko.coingecko_get_exchange 1 parameters

Schema command

kosmo integrations:schema coingecko.coingecko_get_exchange --json

Parameter	Type	Required	Description
`id`	string	yes	CoinGecko exchange ID such as binance or gdax.

coingecko.coingecko_get_exchange_tickers 2 parameters

Schema command

kosmo integrations:schema coingecko.coingecko_get_exchange_tickers --json

Parameter	Type	Required	Description
`id`	string	yes	CoinGecko exchange ID.
`params`	object	no	Optional query parameters such as coin_ids, page, depth, order.

coingecko.coingecko_global 0 parameters

Schema command

kosmo integrations:schema coingecko.coingecko_global --json

Parameter	Type	Required	Description
No parameters.

coingecko.coingecko_global_defi 0 parameters

Schema command

kosmo integrations:schema coingecko.coingecko_global_defi --json

Parameter	Type	Required	Description
No parameters.

coingecko.coingecko_history 3 parameters

Schema command

kosmo integrations:schema coingecko.coingecko_history --json

Parameter	Type	Required	Description
`id`	string	yes	CoinGecko coin ID (e.g. "bitcoin", "ethereum", "solana"). Use coingecko_search_coins to find IDs.
`currency`	string	no	Target currency (default: "usd").
`days`	string	no	Number of days of history (default: "30"). Common values: 1, 7, 14, 30, 90, 365.

coingecko.coingecko_info 1 parameters

Schema command

kosmo integrations:schema coingecko.coingecko_info --json

Parameter	Type	Required	Description
`id`	string	yes	CoinGecko coin ID (e.g. "bitcoin", "ethereum", "solana"). Use coingecko_search_coins to find IDs.

coingecko.coingecko_list_asset_platforms 1 parameters

Schema command

kosmo integrations:schema coingecko.coingecko_list_asset_platforms --json

Parameter	Type	Required	Description
`params`	object	no	Optional query parameters such as filter=nft.

coingecko.coingecko_list_categories 0 parameters

Schema command

kosmo integrations:schema coingecko.coingecko_list_categories --json

Parameter	Type	Required	Description
No parameters.

coingecko.coingecko_list_coins 1 parameters

Schema command

kosmo integrations:schema coingecko.coingecko_list_coins --json

Parameter	Type	Required	Description
`params`	object	no	Optional query parameters: include_platform, status.

coingecko.coingecko_list_entities 0 parameters

Schema command

kosmo integrations:schema coingecko.coingecko_list_entities --json

Parameter	Type	Required	Description
No parameters.

coingecko.coingecko_list_exchange_ids 0 parameters

Schema command

kosmo integrations:schema coingecko.coingecko_list_exchange_ids --json

Parameter	Type	Required	Description
No parameters.

coingecko.coingecko_list_exchanges 1 parameters

Schema command

kosmo integrations:schema coingecko.coingecko_list_exchanges --json

Parameter	Type	Required	Description
`params`	object	no	Optional query parameters: per_page, page.

coingecko.coingecko_markets 6 parameters

Schema command

kosmo integrations:schema coingecko.coingecko_markets --json

Parameter	Type	Required	Description
`ids`	string	no	Comma-separated CoinGecko coin IDs to filter to specific coins (e.g. "bitcoin,ethereum,solana").
`currency`	string	no	Target currency (default: "usd"). Common: usd, eur, gbp, btc.
`category`	string	no	Filter by category (e.g. "decentralized-finance-defi", "layer-1"). Use coingecko_search_coins to find category IDs.
`per_page`	string	no	Number of results per page (default: "20", max: 100).
`page`	string	no	Page number for pagination (default: "1").
`price_change_percentage`	string	no	Comma-separated price change timeframes (default: "24h,7d"). Options: 1h, 24h, 7d, 14d, 30d, 200d, 1y.

coingecko.coingecko_new_coins 0 parameters

Schema command

kosmo integrations:schema coingecko.coingecko_new_coins --json

Parameter	Type	Required	Description
No parameters.

coingecko.coingecko_ohlc 3 parameters

Schema command

kosmo integrations:schema coingecko.coingecko_ohlc --json

Parameter	Type	Required	Description
`id`	string	yes	CoinGecko coin ID (e.g. "bitcoin", "ethereum", "solana"). Use coingecko_search_coins to find IDs.
`currency`	string	no	Target currency (default: "usd").
`days`	string	no	Number of days of OHLC data (default: "30"). Common values: 1, 7, 14, 30, 90, 365.

coingecko.coingecko_price 2 parameters

Schema command

kosmo integrations:schema coingecko.coingecko_price --json

Parameter	Type	Required	Description
`ids`	string	yes	Comma-separated CoinGecko coin IDs (e.g. "bitcoin,ethereum,solana"). Use coingecko_search_coins to find IDs.
`currencies`	string	no	Comma-separated target currencies (default: "usd"). E.g. "usd,eur,btc".

coingecko.coingecko_public_treasury_by_coin 3 parameters

Schema command

kosmo integrations:schema coingecko.coingecko_public_treasury_by_coin --json

Parameter	Type	Required	Description
`entity`	string	yes	companies or governments.
`coin_id`	string	yes	CoinGecko coin ID, such as bitcoin.
`params`	object	no	Optional query parameters: per_page, page, order.

coingecko.coingecko_public_treasury_entity 2 parameters

Schema command

kosmo integrations:schema coingecko.coingecko_public_treasury_entity --json

Parameter	Type	Required	Description
`entity_id`	string	yes	Public treasury entity ID from coingecko_list_entities.
`params`	object	no	Optional holding_amount_change and holding_change_percentage query parameters.

coingecko.coingecko_search_coins 1 parameters

Schema command

kosmo integrations:schema coingecko.coingecko_search_coins --json

Parameter	Type	Required	Description
`query`	string	yes	Search query — coin name or ticker symbol (e.g. "bitcoin", "ETH").

coingecko.coingecko_simple_token_price 3 parameters

Schema command

kosmo integrations:schema coingecko.coingecko_simple_token_price --json

Parameter	Type	Required	Description
`asset_platform_id`	string	yes	Asset platform ID such as ethereum, polygon-pos, or solana.
`contract_addresses`	string	yes	Comma-separated token contract addresses.
`currencies`	string	no	Comma-separated target currencies, default usd.

coingecko.coingecko_token_list 1 parameters

Schema command

kosmo integrations:schema coingecko.coingecko_token_list --json

Parameter	Type	Required	Description
`asset_platform_id`	string	yes	Asset platform ID.

coingecko.coingecko_top_gainers_losers 2 parameters

Schema command

kosmo integrations:schema coingecko.coingecko_top_gainers_losers --json

Parameter	Type	Required	Description
`currency`	string	no	Target currency, default usd.
`params`	object	no	Optional query parameters such as duration and top_coins.

coingecko.coingecko_trending 0 parameters

Schema command

kosmo integrations:schema coingecko.coingecko_trending --json

Parameter	Type	Required	Description
No parameters.

Permissions

Headless calls still follow the integration read/write permission policy. Configure read/write defaults with integrations:configure. Add --force only for trusted automation that should bypass that policy.