快速开始

调用同花顺金融数据接口只需要 3 步：登录 → 签发 API Key → 携带 X-api-key 调用。

1. 登录

使用同花顺账号登录文档站：

登录成功后会回跳到「API Key 管理」页，登录态保存在浏览器 Cookie 中。

进入 API Key 管理，点击 创建 API Key，填写：

提交后会立即返回完整 API Key —— 请妥善保存，关闭弹窗后只能在列表里再次查看。

API Key 与你的同花顺账号绑定。可在「API Key 管理」页的"已创建 API Key"列表中查看和管理已签发的 API Key。

在请求头中携带 X-api-key: <your-api-key>。以行情快照为例：

curl 'https://fuyao.aicubes.cn/api/a-share/prices/snapshot?thscodes=600519.SH' \
  -H 'X-api-key: <your-api-key>'

成功响应统一走 ApiResponse 信封：

{
  "code": 0,
  "message": "success",
  "request_id": "a1b2c3d4",
  "data": {
    "timestamp": 1716105600000,
    "item": [ ]
  }
}

完整端点与参数见 API 参考。

后端 capability 同时以 MCP Tools 形态暴露给 AI Agent 工具链，鉴权复用上一步签发的 API Key，通过环境变量 API_KEY 注入：

export API_KEY="<your-api-key>"

具体工具列表见 MCP 工具概览。