Pulse 开放数据 API

# Pulse 开放数据 API · 调用说明（给 AI 助手）

你可以调用以下 11 个 HTTP GET endpoint 来回答用户关于美国议员持仓和 Polymarket 预测市场的问题。
所有 endpoint 无鉴权、CORS 全开、单次返 1-30 KB 干净 JSON（带 meta + 主体字段）。

## Base URL
https://smartearner.cn/api/data/<tool>

## Polymarket 6 个 tool

| tool | 用途 | query 参数 |
|---|---|---|
| polymarket_list | 列出事件，按 volume 等排序 | limit, sort_by, tag |
| polymarket_get | 拿单事件详情 | id 或 slug |
| polymarket_search | 模糊搜（中英文，含 sub-market 命中） | query, limit |
| polymarket_anomalies | 24h 概率异动事件 | threshold_pp |
| polymarket_top_volume | 24h 成交量 Top N | n |
| polymarket_event_subs | 拿多市场事件所有子市场（FIFA/选举）| id 或 slug, min_prob |

## 议员持仓 5 个 tool

| tool | 用途 | query 参数 |
|---|---|---|
| trades_list | 列出最新交易，倒序 | limit, source |
| trades_by_politician | 某议员所有交易（中英文都行）| name, limit |
| trades_by_ticker | 某股票被谁交易过 | ticker, limit |
| trades_recent | 最近 N 天交易 | days, source, limit |
| trades_search | 模糊搜（中英文）| query, limit |

## 调用流程

1. **识别意图** → 选 tool（按用户问题里的关键词匹配 tool 名）
2. **抽参数** → 从用户问题里提取 ticker / name / slug / query 等
3. **GET 调用** → fetch `https://smartearner.cn/api/data/<tool>?<params>`
4. **解析返值** → `{ meta: {...}, events: [...] }` 或 `{ meta, trades: [...] }` 或 `{ meta, sub_markets: [...] }`
5. **中文总结** 给用户

## 用户问 → 你调什么的对照表

- "Pelosi 最近买啥" → `trades_by_politician?name=Pelosi&limit=10`
- "谁买了 NVDA" → `trades_by_ticker?ticker=NVDA`
- "Polymarket 今天有哪些异动" → `polymarket_anomalies`
- "成交量最高的预测市场" → `polymarket_top_volume?n=10`
- "乌兹别克斯坦能赢世界杯吗" → 先 `polymarket_search?query=乌兹别克斯坦`，从 matched_subs 找到子市场
- "FIFA 冠军概率 >5% 的国家" → `polymarket_event_subs?slug=2026-fifa-world-cup-winner-595&min_prob=0.05`

## 注意

- **数据仅供研究**，不构成投资建议
- 议员持仓有 **T+45 天 PTR 披露延迟**
- 数据来源：Polymarket Gamma / House Clerk PTR / Senate Stock Watcher（全部公开）
- 完整文档：https://smartearner.cn/docs