# AIGU Data API 使用规则（Cursor / Windsurf / Cline / Copilot 通用）

当用户需要 A 股数据（查股价、K线、涨停池、板块、财务报表、除权、交易日历、可转债、打新、ETF）时，
调用 AIGU Data API：`https://aiguq.com`，全部 GET + JSON。API Key 从环境变量 `AIGU_KEY` 读取
（形如 `ak-xxxx`，用户在 https://aiguq.com/console.html 注册获取）。

## 接口速查

| 需求 | 调用 |
|---|---|
| 实时股价 | `GET /v1/quote?code=600519` |
| 批量行情（≤50只，计1次） | `GET /v1/quote/batch?codes=600519,000001` |
| K线（1m/5m/15m/30m/60m/1d/1w/1M） | `GET /v1/kline?code=600519&period=1d&count=60` |
| 复权K线（回测用back） | `&dividend_type=back`（可选 front/front_ratio/back_ratio） |
| 任意区间 | `&start_time=20260101&end_time=20261016` |
| 历史分笔（计5次） | `GET /v1/tick_history?code=600519&date=20261016` |
| 涨幅榜 / 涨停池 | `GET /v1/rank` · `GET /v1/zt_pool` |
| 大盘指数 | `GET /v1/index` |
| 证券列表 | `GET /v1/stock_list?market=SH` |
| 合约信息（涨跌停价/股本） | `GET /v1/instrument?code=600519` |
| 板块列表（申万行业含SW） | `GET /v1/sector_list?keyword=银行` |
| 板块成分股 | `GET /v1/sector?name=1000SW1银行` |
| 指数成分权重 | `GET /v1/index_weight?index=000300.SH` |
| 财务报表（计2次） | `GET /v1/financial?code=600519&table=Income&count=4` |
| 除权除息 | `GET /v1/dividend?code=600519` |
| 交易日历 | `GET /v1/trading_dates?start_time=20260101&end_time=20261231` |
| 可转债 / 打新 / ETF | `GET /v1/cb_info?code=...` · `GET /v1/ipo` · `GET /v1/etf_info?code=...` |
| 查询配额 | `GET /v1/usage` |

## 鉴权与调用约定

- 鉴权：请求头 `X-API-Key: ak-xxx`（推荐）或 URL 参数 `?key=ak-xxx`。
- 代码：`600519` 与 `600519.SH` 等价（6/5/9 开头→沪，其余→深）。
- 单位：价格元；成交量**手**（1手=100股）；成交额元；涨跌幅已乘100。
- 成功 `{"code":0,"data":{...}}`；401=Key无效；429=超限（响应头 `x-rate-reason`）；502=重试。
- 财务数据一次计 2 次配额、历史分笔计 5 次，其余 1 次。体验版每天仅 5 次，连续调用前先查 `/v1/usage`。

## 行为准则

1. 用户问股价/行情 → 直接调用对应接口，把结果整理成易读格式回复（涨跌幅带正负号和%）。
2. 写回测/选股代码时 → K线默认用 `dividend_type=back` 后复权，避免复权未来函数；财务按 `m_anntime`（披露日）对齐。
3. 遇到 429 → 提醒用户配额已用完（体验版5次/天），建议升级或明日重试，不要无脑重试。
4. 展示 K 线数据时保留完整 OHLCV，供用户画图或核对。