Crypto Market Data 🪙#

Query cryptocurrency market data from CoinGecko through AIsa.

Use this skill when you need current prices, historical charts, OHLC candles, token lookup by contract address, market-cap rankings, exchange data, categories, trending searches, or crypto news from a single CLI.

Compatibility#

Works with any agentskills.io-compatible harness, including:

• Claude Code and Claude
• OpenAI Codex
• Cursor
• Gemini CLI
• OpenCode, Goose, OpenClaw, Hermes
• and other tools that implement the Agent Skills specification

Requires Python 3, a POSIX shell, and AISA_API_KEY (get one at aisa.one).

What you can do#

Price tracking#

text

"What is the current price of bitcoin and ethereum in USD and EUR?"

Historical charts#

text

"Get the last 30 days of BTC price data in USD"

OHLC candles#

text

"Pull 7-day OHLC candles for solana"

Token lookup by contract address#

text

"Find the CoinGecko price for USDC at 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 on Ethereum"

Market-cap screening#

text

"List the top 25 coins by market cap with 24h change"

Exchange research#

text

"What are Binance's top trading pairs by trust score?"

Trend discovery#

text

"What are the top trending coin searches on CoinGecko right now?"

Category breakdown#

text

"Rank DeFi coin categories by market cap"

Quick start#

bash

export AISA_API_KEY="your-key"

Simple prices#

bash

# Current price of bitcoin and ethereum in USD + EUR with 24h change
python3 scripts/coingecko_client.py simple price \
  --ids bitcoin,ethereum --vs usd,eur --include-24hr-change

# All supported fiat/crypto currencies usable as vs_currency
python3 scripts/coingecko_client.py simple supported-currencies

# Price by on-chain contract address (USDC on Ethereum)
python3 scripts/coingecko_client.py simple token-price \
  --platform ethereum \
  --addresses 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 \
  --vs usd --include-24hr-vol

Coin data, markets, and history#

bash

# Full coin data for bitcoin
python3 scripts/coingecko_client.py coins data --id bitcoin

# Top 25 coins by market cap (USD)
python3 scripts/coingecko_client.py coins markets \
  --vs usd --order market_cap_desc --per-page 25

# Directory of all coins with ids/symbols/names
python3 scripts/coingecko_client.py coins list

# Historical snapshot for a specific date (dd-mm-yyyy)
python3 scripts/coingecko_client.py coins history \
  --id bitcoin --date 01-01-2024

# 30-day daily market chart for BTC in USD
python3 scripts/coingecko_client.py coins chart \
  --id bitcoin --vs usd --days 30

# Explicit UNIX timestamp range
python3 scripts/coingecko_client.py coins chart-range \
  --id bitcoin --vs usd --from 1704067200 --to 1706745600

# 7-day OHLC candles
python3 scripts/coingecko_client.py coins ohlc \
  --id bitcoin --vs usd --days 7

# Exchange-listed trading pairs for a coin
python3 scripts/coingecko_client.py coins tickers \
  --id bitcoin --order trust_score_desc

# Full data / chart by contract address
python3 scripts/coingecko_client.py coins contract \
  --platform ethereum \
  --address 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48

python3 scripts/coingecko_client.py coins contract-chart \
  --platform ethereum \
  --address 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 \
  --vs usd --days 14

Categories#

bash

# All category IDs and names
python3 scripts/coingecko_client.py categories list

# Category leaderboard (market cap, volume, top-3 coins)
python3 scripts/coingecko_client.py categories markets \
  --order market_cap_desc

Exchanges#

bash

# Exchanges with current trading volume and metadata
python3 scripts/coingecko_client.py exchanges list --per-page 50

# Just the ID -> name map (useful for resolving user input)
python3 scripts/coingecko_client.py exchanges id-map

# Detailed data for a specific exchange
python3 scripts/coingecko_client.py exchanges data --id binance

# Trading pairs on a specific exchange
python3 scripts/coingecko_client.py exchanges tickers \
  --id binance --order trust_score_desc

News and trending#

bash

python3 scripts/coingecko_client.py news
python3 scripts/coingecko_client.py trending

Inputs and outputs#

• Input: coin IDs (for example bitcoin, ethereum, solana), fiat/crypto vs_currency codes ( usd, eur, btc), category IDs, exchange IDs, or supported platform + contract address pairs. Use coins list and exchanges id-map to resolve user-friendly names to CoinGecko IDs.
• Output: JSON printed to stdout, matching the CoinGecko schema for each endpoint: price dictionaries, coin and exchange objects, arrays of timestamped [ts, value] pairs for charts, [ts, o, h, l, c] tuples for OHLC, ticker arrays, and related market-data payloads.

When to use / When not to use#

Use when:

• You need current or historical crypto prices, market caps, volumes, or charts.
• You need to look up a token by its on-chain contract address ( ethereum, binance-smart-chain, polygon-pos, and similar supported platforms).
• You need exchange-level data such as trust scores, volumes, or per-pair tickers.
• You want to screen categories such as DeFi, AI, or L1s, or surface trending coins.

Do not use when:

• You need equities or traditional finance data — use the marketpulse skill.
• You need prediction-market order-book depth for platforms such as Polymarket or Kalshi — use prediction-market-data.
• You need on-chain wallet balances, transfers, or gas traces — CoinGecko is a pricing and market-data source, not a node RPC.

Requirements#

• Python 3, curl, POSIX shell
• AISA_API_KEY — required, get one at aisa.one

API reference#

This skill calls the following AIsa CoinGecko endpoints directly:

• Simple Price — current price for one or more coins in any supported currencies
• Supported Currencies — list of all supported fiat and crypto vs_currency codes
• Coin Price by Token Address — current price of tokens by contract address on a supported platform
• Coins List (ID Map) — directory of all coins with id, symbol, and name
• Coins Markets — all coins with full market data (price, market cap, volume, etc.)
• Coin Data by ID — current coin info including price, markets, links, community and developer data
• Coin Tickers — exchange-listed trading pairs for a coin
• Coin Historical Data — historical snapshot (price, market cap, volume) for a given date
• Coin Historical Chart — historical market data over the last N days
• Coin Market Chart Range — historical market data within an explicit UNIX timestamp range
• Coin OHLC — OHLC candles for a coin
• Coin Data by Token Address — full coin data by contract address on a supported platform
• Coin Historical Chart by Contract — historical market data for a token by contract address
• Categories List — all coin categories used by CoinGecko
• Categories with Market Data — categories with market cap, volume, and top-3 coins
• Exchanges List — all exchanges with current trading volume and metadata
• Exchanges List (ID Map) — exchange identifiers and names for mapping
• Exchange Data by ID — detailed data for a single exchange (volume, tickers, trust score)
• Exchange Tickers — trading pairs listed on a given exchange
• Crypto News — latest crypto news articles aggregated by CoinGecko
• Trending Search — top-7 trending coin searches in the last 24 hours

See the full AIsa API Reference for the complete catalog.

License#

MIT — see LICENSE at the repo root.