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.

finance

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.

8 functions 8 read 0 write API key auth

Submit CoinGecko feedback View package source

CoinGecko CLI Setup

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

# 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 use the same stored profile from scripts, coding CLIs, Lua code mode, and the MCP gateway.

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

Call CoinGecko Headlessly

Use the generic call form when another coding CLI or script needs a stable universal interface.

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

Use the provider shortcut form for shorter human-facing commands.

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

Agent Discovery Commands

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

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

All CLI Functions

Every function below can be called headlessly. The generic form is stable across all integrations; the provider shortcut is shorter but specific to CoinGecko.

`coingecko.coingecko_global`

Read read

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

Parameters: none

Generic CLI call

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

Provider shortcut

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

`coingecko.coingecko_history`

Read read

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

Parameters: id, currency, days

Generic CLI call

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

Provider shortcut

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

`coingecko.coingecko_info`

Read read

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.

Parameters: id

Generic CLI call

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

Provider shortcut

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

`coingecko.coingecko_markets`

Read read

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.

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

Generic CLI 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

Provider 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_ohlc`

Read read

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

Parameters: id, currency, days

Generic CLI call

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

Provider shortcut

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

`coingecko.coingecko_price`

Read read

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.

Parameters: ids, currencies

Generic CLI call

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

Provider shortcut

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

`coingecko.coingecko_search_coins`

Read read

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

Parameters: query

Generic CLI call

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

Provider shortcut

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

`coingecko.coingecko_trending`

Read read

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

Parameters: none

Generic CLI call

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

Provider shortcut

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

Function Schemas

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

`coingecko.coingecko_global`

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

Operation: Read read
Schema command: kosmo integrations:schema coingecko.coingecko_global --json

Parameter	Type	Required	Description
No parameters.

`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.

Operation: Read read
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`

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.

Operation: Read read
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_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.

Operation: Read read
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_ohlc`

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

Operation: Read read
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`

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.

Operation: Read read
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_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.

Operation: Read read
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_trending`

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

Operation: Read read
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.