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

> 面向 Agent 的实时与历史加密货币市场数据。

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

Crypto Market Data 让 Agent 查询加密货币价格、coin 详情、图表、OHLC K 线、合约地址 token lookup、market-cap screening、交易所 tickers 和分类数据。

## 安装

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

## Agent 可以做什么？

<CardGroup cols={2}>
  <Card title="实时价格" icon="bitcoin-sign">
    查询 BTC、ETH、SOL 等币种现价和 24h 变化。
  </Card>

  <Card title="历史图表" icon="chart-area">
    获取 market chart、range chart 和 OHLC。
  </Card>

  <Card title="Token lookup" icon="magnifying-glass">
    按合约地址查询 token 信息。
  </Card>

  <Card title="市场筛选" icon="filter">
    按市值、交易量、分类或交易所数据筛选。
  </Card>
</CardGroup>

## 快速开始

```bash theme={null}
# 当前价格与 24h 变化
curl "https://api.aisa.one/apis/v1/coingecko/simple/price?ids=bitcoin,ethereum&vs_currencies=usd&include_24hr_change=true" \
  -H "Authorization: Bearer $AISA_API_KEY"

# 市值列表
curl "https://api.aisa.one/apis/v1/coingecko/coins/markets?vs_currency=usd&order=market_cap_desc" \
  -H "Authorization: Bearer $AISA_API_KEY"
```

## 何时使用

* 加密资产价格监控
* Token 基本信息和合约查询
* 历史走势、OHLC 和波动分析
* 交易所 tickers 和市场分类研究

## 何时不要使用

* 不要把价格接口当成交易执行接口。
* 不要在没有风险说明的情况下输出投资建议。
* 对低流动性 token 需要提示数据和价格风险。

## Requirements

需要 `AISA_API_KEY`。查询参数以 CoinGecko 风格为主，具体字段见 API reference。

## 开始使用

```bash theme={null}
export AISA_API_KEY="YOUR_AISA_API_KEY"
npm install -g @aisa-one/cli
aisa skills install crypto-market-data
```

## 相关

<CardGroup cols={3}>
  <Card title="AIsa Market" icon="chart-line" href="/zh/agent-skills/market">股票与加密综合数据。</Card>
  <Card title="Trend Forecast" icon="bullseye" href="/zh/agent-skills/trend-forecast">多信号趋势预测。</Card>
  <Card title="CoinGecko API" icon="code" href="/api-reference/coingecko/get_coingecko-simple-price">CoinGecko endpoint。</Card>
</CardGroup>
