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

# 预测市场数据

> 面向自主 Agent 的 Polymarket 与 Kalshi 市场发现/交易历史挂载数据。

[在 GitHub 上查看 →](https://github.com/AIsa-team/agent-skills/tree/main/prediction-market-data)

**面向自主 Agent 的预测市场发现数据。** 一个 `AISA_API_KEY` 即可读取已挂载的 Polymarket 和 Kalshi 端点，用于市场发现、事件查询、活动记录和 Kalshi 交易历史。

## 安装

如果还没有安装 AIsa CLI，请先安装：

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

然后安装该技能：

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

## Agent 可以用它做什么？

<CardGroup cols={2}>
  <Card title="市场发现" icon="magnifying-glass">
    “查找与某个主题相关的 Polymarket 和 Kalshi 市场。”
  </Card>

  <Card title="事件查询" icon="calendar-days">
    “浏览 Polymarket 事件组及其关联市场。”
  </Card>

  <Card title="交易历史" icon="chart-line">
    “按可选 ticker 和 block trade 过滤条件拉取近期 Kalshi 交易记录。”
  </Card>

  <Card title="活动检查" icon="wave-pulse">
    “检查特定用户在某段时间内的 Polymarket 活动。”
  </Card>

  <Card title="流动性初筛" icon="droplet">
    “使用市场发现响应中的成交量和流动性字段，决定哪些市场值得进一步检查。”
  </Card>

  <Card title="研究流程" icon="shuffle">
    “在使用交易所原生工具检查价格、订单簿或执行前，先构建候选集合。”
  </Card>
</CardGroup>

## 核心能力

* **市场发现** —— 使用 provider 支持的过滤条件获取 Polymarket 和 Kalshi 市场。
* **事件索引** —— 获取 Polymarket 事件/分组数据。
* **交易历史** —— 使用 `limit`、`cursor`、`ticker`、`min_ts`、`max_ts` 和 `is_block_trade` 获取 Kalshi trades。
* **活动查询** —— 使用 `user` 以及可选时间/市场过滤条件获取 Polymarket 用户活动。

<Warning>
  AIsa 当前挂载的是下方列出的端点。旧版 AIsa-hosted price、orderbook、wallet、candlestick 和 matching-market 端点示例已移除，因为鉴权探测返回 `api endpoint not found`。
</Warning>

## 快速开始

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

### Polymarket

```bash theme={null}
# 市场发现
curl "https://api.aisa.one/apis/v1/polymarket/markets?limit=5" \
  -H "Authorization: Bearer ***""

# 事件
curl "https://api.aisa.one/apis/v1/polymarket/events?limit=5" \
  -H "Authorization: Bearer ***""

# 指定用户地址的活动
curl "https://api.aisa.one/apis/v1/polymarket/activity?user=WALLET_ADDRESS&limit=5" \
  -H "Authorization: Bearer ***""
```

### Kalshi

```bash theme={null}
# 市场发现
curl "https://api.aisa.one/apis/v1/kalshi/markets?limit=5&status=open" \
  -H "Authorization: Bearer ***""

# 交易
curl "https://api.aisa.one/apis/v1/kalshi/trades?limit=5&is_block_trade=false" \
  -H "Authorization: Bearer ***""
```

## Python 客户端

```bash theme={null}
# Polymarket
python3 scripts/prediction_market_client.py poly markets --limit 5
python3 scripts/prediction_market_client.py poly events --limit 5
python3 scripts/prediction_market_client.py poly activity --user WALLET_ADDRESS --limit 5

# Kalshi
python3 scripts/prediction_market_client.py kalshi markets --limit 5 --status open
python3 scripts/prediction_market_client.py kalshi trades --limit 5 --is-block-trade false
```

## 端点参考

| Endpoint               | Method | Purpose                                                                       |
| ---------------------- | ------ | ----------------------------------------------------------------------------- |
| `/polymarket/markets`  | GET    | [Polymarket markets](/api-reference/prediction-market/get_polymarket-markets) |
| `/polymarket/events`   | GET    | [Polymarket events](/api-reference/prediction-market/get_polymarket-events)   |
| `/polymarket/activity` | GET    | [Activity](/api-reference/prediction-market/get_polymarket-activity)          |
| `/kalshi/markets`      | GET    | [Kalshi markets](/api-reference/prediction-market/get_kalshi-markets)         |
| `/kalshi/trades`       | GET    | [Kalshi trades](/api-reference/prediction-market/get_kalshi-trades)           |

## 开始使用

1. 在 [aisa.one](https://aisa.one) 注册（新账户有 \$2 免费额度）。
2. 从控制台生成 API key。
3. 设置 key 并安装技能：
   ```bash theme={null}
   export AISA_API_KEY="your-key"
   npm install -g @aisa-one/cli
   aisa skills install prediction-market-data
   ```

## 相关

<CardGroup cols={3}>
  <Card title="预测市场 API 参考" icon="chart-simple" href="/api-reference/prediction-market/get_polymarket-markets">
    已挂载的 Polymarket 和 Kalshi 发现端点。
  </Card>

  <Card title="套利技能" icon="scale-balanced" href="/zh/agent-skills/prediction-market-arbitrage">
    跨平台市场研究的候选发现流程。
  </Card>

  <Card title="错误代码" icon="triangle-exclamation" href="/api-reference/errors">
    处理上游交易所错误。
  </Card>
</CardGroup>