# 股票数据API服务平台

> 全市场 A 股数据 API：沪深北三市场股票 / ETF / 可转债 / 指数的日线、分钟 K 线、分笔成交、复权因子、财务、ST 名单、特殊名单、沪深港通等结构化数据。提供 REST API（JSON 信封）、Python SDK（pandas DataFrame）与官方 MCP Server 三种接入方式，响应字段口径统一、证券代码自动归一、错误信息自解释。数据每日 16:00 更新，仅供研究参考，不构成投资建议。

本页面向 LLM 与 AI Agent；人类用户请从 [首页](http://www.369.top/) 开始。

## 文档

- [API 文档](http://www.369.top/docs)：全部端点契约（参数表 / 出参表 / 三种语言示例），每个端点独立成页
- [AI Agent 接入指南](http://www.369.top/ai-agents)：MCP Server 安装与 Claude Desktop / Cursor 配置、工具清单、快速开始
- [定价与档位](http://www.369.top/pricing)：免费版长期免费（日线全历史 + 500 次/天），基础 / 专业 / 旗舰按需升级
- [服务条款](http://www.369.top/terms) · [免责声明](http://www.369.top/disclaimer)

## 机器可读资源

- OpenAPI 规范：https://api.369.top/openapi.json （FastAPI 自动生成）
- MCP Server：`pip install 'top369[mcp]'` 后运行 `top369-mcp`（stdio），环境变量 `TOP369_API_KEY` 传 API Key
- Python SDK：`pip install top369`，`gp.pro_api("KEY")` 初始化，方法与 REST 端点一一对应

## 调用约定

- 认证：SDK / REST 用请求头 `X-API-Key: sk-...`（Key 可禁用/启用，注册即得，http://www.369.top/app/auth）；网页端控制台用 `Authorization: Bearer <JWT>` 短时会话，两者共用档位与配额
- 错误码：401=Key 无效，403=档位不足，429=当日配额用尽（次日 0 点重置），响应文案均写明原因与出路
- 证券代码：`600519.SH` / `sh600519` / `600519` 等写法均接受，响应统一返回带市场前缀完整码
- 单位：volume=股，amount=元（全接口一致，无需换算）