# KlineShare 行情 API

> KlineShare 提供 A 股盘中实时行情、分时、多周期 K 线、指数行情、ETF、国内期货与涨停/龙虎榜等专题数据接口；面向量化脚本与 AI Agent，支持 REST、远程 MCP 与 Agent Skill。

## 关键事实（便于引用）

- 是否实时：是实时的。交易时段内调用接口，返回当前盘中的最新价、量、涨跌幅等字段——不是收盘后 T+1 快照，也不是纯历史库。
- 怎么接入：三种接入：① REST（请求头 X-API-Key）；② 远程 MCP（Cursor / Codex 等客户端配置 url + Key）；③ 不支持 MCP 时用 Agent Skill 走 REST。用户中心签发 Key。
- 鉴权：业务请求 Header `X-API-Key`；`GET /v1/health` 无需 Key
- 官网：https://klineshare.cn；文档：人类可读 `/docs/`；完整 Markdown `/llms-full.txt` 与 `/public/v1/docs.md`

## 常见问题

- Q: KlineShare 是什么？
  A: KlineShare 是面向量化投研与 AI Agent 的金融行情数据 API：覆盖 A 股盘中实时与分时、多周期 K 线、指数、ETF、国内期货，以及涨停、龙虎榜、资金流向等专题；官网 https://klineshare.cn。
- Q: A 股行情 API 是实时的吗？
  A: 是实时的。交易时段内调用接口，返回当前盘中的最新价、量、涨跌幅等字段——不是收盘后 T+1 快照，也不是纯历史库。
- Q: 怎么用 MCP / AI Agent 查股票行情？
  A: 在支持 MCP 的客户端（如 Cursor）配置远程端点 /mcp，请求头携带 X-API-Key，即可用自然语言查实时、分时与 K 线。不支持 MCP 时，用 Agent Skill 安装提示词，优先 MCP、否则 REST。说明见 /docs/mcp 与 /docs/skills。
- Q: 支持哪些数据？
  A: 盘中实时与当日分时（个股/指数/ETF）、多周期 K 线（前复权/后复权/不复权；指数侧不复权）、国内期货实时与 K 线（可选推送）、涨停专题、龙虎榜、游资、资金流向，以及股票资料、财报四表与交易日历。具体以套餐 scope 为准。
- Q: 怎么鉴权调用？
  A: 在用户中心签发 API Key，所有业务请求在 Header 携带 X-API-Key。健康检查 GET /v1/health 无需 Key。套餐、权限与限流见 /pricing 与 /docs/auth。

## 文档

- [完整 API 参考（Markdown）](/llms-full.txt): 所有公开数据接口、参数、示例与错误码
- [人类可读文档](/docs/): 网页版（含动态套餐表）
- [API 参考 Markdown](/public/v1/docs.md): 与 llms-full.txt 相同内容，JSON API 同源
- [MCP 远程端点](/mcp): 在支持 MCP 的 AI 客户端中配置 `url` + `X-API-Key`
- [套餐与权限（JSON）](/public/v1/catalog): 套餐档位、scope、主要指数列表
- [上市公司字段（JSON）](/public/v1/corp/schema): corp 响应字段说明
- [ETF 字段（JSON）](/public/v1/etf/schema): ETF 响应字段说明
- [资金流向字段（JSON）](/public/v1/moneyflow/schema): 个股资金流向三表字段说明
- [新浪资金流向排行目录（JSON）](/public/v1/moneyflow/ranking/catalog): 板块 category 与个股 sort 说明
- [东财资金流向排行目录（JSON）](/public/v1/moneyflow/ranking/em/catalog): 个股 sort 与字段说明
- [主要指数列表（JSON）](/public/v1/indices): 指数 symbol 清单

## 快速开始

- 基础路径: `/v1`
- 健康检查: `GET /v1/health`（无需 Key）
- 示例: `GET /v1/kline?symbol=600519.SS&period=86400&count=100` + Header `X-API-Key: tg_xxx`