> ## Documentation Index
> Fetch the complete documentation index at: https://aisa.one/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Crypto Market Data

> Real-time and historical cryptocurrency market data for autonomous agents — prices, coin details, charts, OHLC candles, token lookup by contract address, market-cap screening, exchange tickers, categories, trending searches, and crypto news.

[View on GitHub →](https://github.com/AIsa-team/agent-skills/tree/main/crypto-market-data)

**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:

```bash theme={null}
npm install -g @aisa-one/cli
```

Then install the skill:

```bash theme={null}
aisa skills install crypto-market-data
```

## What can agents do with it?

<CardGroup cols={2}>
  <Card title="Price tracking" icon="dollar-sign">
    "Get current BTC and ETH prices in USD and EUR with 24-hour change."
  </Card>

  <Card title="Historical charts" icon="chart-line">
    "Pull bitcoin's 30-day price chart in USD for my dashboard."
  </Card>

  <Card title="OHLC candles" icon="chart-candlestick">
    "Return the last 7 days of OHLC candles for ethereum."
  </Card>

  <Card title="On-chain token lookup" icon="magnifying-glass-dollar">
    "Identify the ERC-20 at address 0xA0b8…eB48 and pull its price."
  </Card>

  <Card title="Market-cap screening" icon="ranking-star">
    "Show me the top 25 coins by market cap, ordered descending."
  </Card>

  <Card title="Exchange research" icon="building-columns">
    "List Binance tickers ordered by trust score."
  </Card>
</CardGroup>

## 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

```bash theme={null}
export AISA_API_KEY="your-key"
```

### Simple prices

```bash theme={null}
# 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

```bash theme={null}
python3 scripts/coingecko_client.py coins markets \
  --vs usd --order market_cap_desc --per-page 25
```

### Historical chart

```bash theme={null}
python3 scripts/coingecko_client.py coins chart --id bitcoin --vs usd --days 30
```

### OHLC candles

```bash theme={null}
python3 scripts/coingecko_client.py coins ohlc --id bitcoin --vs usd --days 7
```

### Token lookup by contract address

```bash theme={null}
python3 scripts/coingecko_client.py coins contract \
  --platform ethereum \
  --address 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48
```

### Exchange tickers

```bash theme={null}
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](/agent-skills/marketpulse) instead
* Prediction-market order-book depth — use [Prediction Market Data](/agent-skills/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](https://aisa.one) — new accounts start with \$2 free credit)
* Compatible with agentskills.io-standard harnesses

## Endpoint reference

| Endpoint                                                         | Method | Purpose                                                                                    |
| ---------------------------------------------------------------- | ------ | ------------------------------------------------------------------------------------------ |
| `/coingecko/simple/price`                                        | GET    | [Simple price](/api-reference/coingecko/simple-price)                                      |
| `/coingecko/simple/supported_vs_currencies`                      | GET    | [Supported currencies](/api-reference/coingecko/supported-currencies)                      |
| `/coingecko/simple/token_price/{id}`                             | GET    | [Coin price by token address](/api-reference/coingecko/coin-price-by-token-address)        |
| `/coingecko/coins/list`                                          | GET    | [Coins list](/api-reference/coingecko/coins-list)                                          |
| `/coingecko/coins/markets`                                       | GET    | [Coins markets](/api-reference/coingecko/coins-markets)                                    |
| `/coingecko/coins/{id}`                                          | GET    | [Coin data by id](/api-reference/coingecko/coin-data-by-id)                                |
| `/coingecko/coins/{id}/history`                                  | GET    | [Coin historical data](/api-reference/coingecko/coin-historical-data)                      |
| `/coingecko/coins/{id}/market_chart`                             | GET    | [Coin historical chart](/api-reference/coingecko/coin-historical-chart)                    |
| `/coingecko/coins/{id}/market_chart/range`                       | GET    | [Coin market chart range](/api-reference/coingecko/coin-market-chart-range)                |
| `/coingecko/coins/{id}/ohlc`                                     | GET    | [Coin OHLC](/api-reference/coingecko/coin-ohlc)                                            |
| `/coingecko/coins/{id}/tickers`                                  | GET    | [Coin tickers](/api-reference/coingecko/coin-tickers)                                      |
| `/coingecko/coins/{id}/contract/{contract_address}`              | GET    | [Coin data by token address](/api-reference/coingecko/coin-data-by-token-address)          |
| `/coingecko/coins/{id}/contract/{contract_address}/market_chart` | GET    | [Historical chart by contract](/api-reference/coingecko/coin-historical-chart-by-contract) |
| `/coingecko/coins/categories/list`                               | GET    | [Categories list](/api-reference/coingecko/categories-list)                                |
| `/coingecko/coins/categories`                                    | GET    | [Categories with market data](/api-reference/coingecko/categories-with-market-data)        |
| `/coingecko/exchanges`                                           | GET    | [Exchanges list](/api-reference/coingecko/exchanges-list)                                  |
| `/coingecko/exchanges/list`                                      | GET    | [Exchange id map](/api-reference/coingecko/exchanges-list-id-map)                          |
| `/coingecko/exchanges/{id}`                                      | GET    | [Exchange data by id](/api-reference/coingecko/exchange-data-by-id)                        |
| `/coingecko/exchanges/{id}/tickers`                              | GET    | [Exchange tickers](/api-reference/coingecko/exchange-tickers)                              |
| `/coingecko/search/trending`                                     | GET    | [Trending search](/api-reference/coingecko/trending-search)                                |
| `/coingecko/news`                                                | GET    | [Crypto news](/api-reference/coingecko/crypto-news)                                        |

## Get started

1. Sign up at [aisa.one](https://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:
   ```bash theme={null}
   npm install -g @aisa-one/cli
   aisa skills install crypto-market-data
   ```
4. Start a new session in your agent — the skill loads automatically.

## Related

<CardGroup cols={3}>
  <Card title="CoinGecko API reference" icon="coins" href="/api-reference/coingecko/simple-price">
    Every endpoint this skill wraps, with interactive playgrounds.
  </Card>

  <Card title="MarketPulse" icon="chart-line" href="/agent-skills/marketpulse">
    Equities counterpart — stocks, financials, filings, macro.
  </Card>

  <Card title="Prediction Market Data" icon="scale-balanced" href="/agent-skills/prediction-market-data">
    Polymarket and Kalshi for event-probability data.
  </Card>
</CardGroup>