finance
CoinGecko CLI for Headless Automation
Use the CoinGecko CLI for headless automation with headless JSON commands, schema discovery, credentials, and permission controls.
8 functions 8 read 0 write API key auth
CoinGecko CLI for Headless Automation
Use KosmoKrator as a non-interactive integration runtime for local automations and wrappers.
Use headless automation when another tool needs a stable local command surface. The CoinGecko CLI uses the same integration registry as the TUI, Lua runtime, and MCP gateway, but returns predictable command output for automation.
Command Shape
# CoinGecko CLI for Headless Automation
kosmokrator integrations:configure coingecko --enable --read allow --write ask --json
kosmo integrations:call coingecko.coingecko_global '{}' --json Discovery Before Execution
Agents and scripts can inspect CoinGecko docs and schemas 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 Useful CoinGecko CLI Functions
| Function | Type | Parameters | Description |
|---|---|---|---|
coingecko.coingecko_global | Read | none | Get overall crypto market statistics — total market cap, BTC dominance, active cryptocurrencies, trading volume, and more. |
coingecko.coingecko_history | Read | id, currency, days | Get historical price, volume, and market cap chart data for a cryptocurrency over a time period. Returns timestamped data points with summary statistics. |
coingecko.coingecko_info | Read | id | 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. |
coingecko.coingecko_markets | Read | ids, currency, category, per_page, page, price_change_percentage | 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. |
coingecko.coingecko_ohlc | Read | id, currency, days | Get OHLC (Open/High/Low/Close) candlestick data for a cryptocurrency for technical analysis. |
coingecko.coingecko_price | Read | ids, currencies | 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. |
coingecko.coingecko_search_coins | Read | query | Find cryptocurrencies by name or ticker symbol (e.g. "bitcoin", "ETH", "solana"). Returns matching coin IDs which are needed for other CoinGecko tools. |
coingecko.coingecko_trending | Read | none | Get the top trending cryptocurrencies in the last 24 hours based on search activity on CoinGecko. |
Automation Notes
- Use
--jsonfor machine-readable output. - Keep credentials out of argv by using environment variables or stored KosmoKrator configuration.
- Configure read/write policy before unattended runs; use
--forceonly for trusted automation. - Use the MCP gateway instead when the agent needs dynamic tool discovery inside a conversation.