Skip to main content
View on GitHub → Complete crypto market data for autonomous agents. One AISA_API_KEY unlocks CoinGecko — prices, charts, OHLC candles, on-chain token lookup, exchange tickers, trending coins, and news. Everything an agent needs to research, screen, and track the crypto market.

​
Install

First, install the AIsa CLI if you have not already: 
npm install -g @aisa-one/cli
Then install the skill: 
aisa skills install crypto-market-data

​
What can agents do with it?

Price tracking

“Get current BTC and ETH prices in USD and EUR with 24-hour change.”

Historical charts

“Pull bitcoin’s 30-day price chart in USD for my dashboard.”

OHLC candles

“Return the last 7 days of OHLC candles for ethereum.”

On-chain token lookup

“Identify the ERC-20 at address 0xA0b8…eB48 and pull its price.”

Market-cap screening

“Show me the top 25 coins by market cap, ordered descending.”

Exchange research

“List Binance tickers ordered by trust score.”

​
Core capabilities

  • Simple prices — current prices across fiat and crypto currencies, with optional market-cap / 24h-volume / 24h-change includes
  • Coin data — full coin profile, lists, historical snapshots, market charts, OHLC candles, tickers
  • Contract-based lookup — resolve a token by contract address on a supported platform (Ethereum, BSC, Polygon, etc.) and pull its price or full profile
  • Markets & screening — coins by market cap with flexible ordering and pagination
  • Categories — category lists and per-category market leaderboards (DeFi, AI, L1s, etc.)
  • Exchanges — exchange lists, detailed data, trading pairs, ID mappings
  • Trending & news — trending search queries and current crypto news

​
Quick start

export AISA_API_KEY="your-key"

​
Simple prices

# Current prices with 24h change
python3 scripts/coingecko_client.py simple price \
  --ids bitcoin,ethereum --vs usd,eur --include-24hr-change

# Or direct curl
curl "https://api.aisa.one/apis/v1/coingecko/simple/price?ids=bitcoin,ethereum&vs_currencies=usd,eur&include_24hr_change=true" \
  -H "Authorization: Bearer $AISA_API_KEY"

​
Market-cap screening

python3 scripts/coingecko_client.py coins markets \
  --vs usd --order market_cap_desc --per-page 25

​
Historical chart

python3 scripts/coingecko_client.py coins chart --id bitcoin --vs usd --days 30

​
OHLC candles

python3 scripts/coingecko_client.py coins ohlc --id bitcoin --vs usd --days 7

​
Token lookup by contract address

python3 scripts/coingecko_client.py coins contract \
  --platform ethereum \
  --address 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48

​
Exchange tickers

python3 scripts/coingecko_client.py exchanges tickers \
  --id binance --order trust_score_desc

​
When to use it

  • Cryptocurrency price tracking and portfolio analysis
  • Token identification via on-chain contract addresses
  • Market-cap screening and category breakdowns
  • Exchange-level research (trust scores, trading pairs, tickers)
  • Current and historical crypto data for reports and dashboards

​
When not to use it

  • Traditional equities data — use MarketPulse instead
  • Prediction-market order-book depth — use Prediction Market Data
  • On-chain wallet operations (balance lookups, transaction traces) — different specialized tools

​
Requirements

  • Python 3, curl, POSIX shell
  • AISA_API_KEY (sign up at aisa.one — new accounts start with $2 free credit)
  • Compatible with agentskills.io-standard harnesses

​
Endpoint reference

EndpointMethodPurpose
/coingecko/simple/priceGETSimple price
/coingecko/simple/supported_vs_currenciesGETSupported currencies
/coingecko/simple/token_price/{id}GETCoin price by token address
/coingecko/coins/listGETCoins list
/coingecko/coins/marketsGETCoins markets
/coingecko/coins/{id}GETCoin data by id
/coingecko/coins/{id}/historyGETCoin historical data
/coingecko/coins/{id}/market_chartGETCoin historical chart
/coingecko/coins/{id}/market_chart/rangeGETCoin market chart range
/coingecko/coins/{id}/ohlcGETCoin OHLC
/coingecko/coins/{id}/tickersGETCoin tickers
/coingecko/coins/{id}/contract/{contract_address}GETCoin data by token address
/coingecko/coins/{id}/contract/{contract_address}/market_chartGETHistorical chart by contract
/coingecko/coins/categories/listGETCategories list
/coingecko/coins/categoriesGETCategories with market data
/coingecko/exchangesGETExchanges list
/coingecko/exchanges/listGETExchange id map
/coingecko/exchanges/{id}GETExchange data by id
/coingecko/exchanges/{id}/tickersGETExchange tickers
/coingecko/search/trendingGETTrending search
/coingecko/newsGETCrypto news

​
Get started

  1. Sign up at aisa.one (new accounts start with $2 free credit).
  2. Generate an API key from the console.
  3. export AISA_API_KEY="your-key" and install the skill: 
    npm install -g @aisa-one/cli
aisa skills install crypto-market-data
  4. Start a new session in your agent — the skill loads automatically.

CoinGecko API reference

Every endpoint this skill wraps, with interactive playgrounds.

MarketPulse

Equities counterpart — stocks, financials, filings, macro.

Prediction Market Data

Polymarket and Kalshi for event-probability data.