Agent AI 对接指南

一键赋予 AI 金融数据能力

量脉平台提供 ~100+ 金融数据 API，涵盖实时行情、历史 K 线、龙虎榜、财务数据、资金流向等。下载下方 JSON 文件，直接导入 OpenAI GPTs / Dify / Coze / 扣子等 AI 平台， AI 即可自动理解并正确调用全部接口。

↓ 下载 OpenAPI 3.0 JSON ↓ 下载 Function Calling Schema

两个文件包含的接口数据完全一致，区别在于格式与适用平台：

OPENAPI 3.0 是一份完整的 HTTP API 描述文件，其中定义了网关地址、请求方式、参数位置、响应结构等全部细节。导入 GPTs Action 或 Coze 插件后，平台会自动生成请求配置和参数填表界面，无需二次开发。

FUNCTION CALLING SCHEMA 是一组函数签名列表，仅包含接口名称、参数含义和字段说明，不包含 HTTP 层面的 URL、Content-Type 等。适合 Dify 工具、LangChain、自建 Agent 等场景——由开发者自行编写 HTTP 调用逻辑， AI 仅负责生成函数的参数值。

两者数据源均与 /docs 文档同步，导入后 AI 即可正确理解所有 ~100+ 接口的参数与返回值。

让 AI Agent 自动获取接口能力

无需手动下载再上传。将下方提示词直接发送给你的 AI Agent，Agent 会自行访问链接拉取 JSON 文件并注册全部金融数据接口。

提示词示例（点击右上角按钮一键复制，发送给 Agent 即可）

// 将以下内容发送给 AI Agent
访问 https://liangmai.pro/agent-skills 下载 OpenAPI 3.0 JSON 文件，解析其中的全部接口定义并注册为可调用工具。
调用方式：统一 POST https://liangmai.pro/api/gateway，body 为 application/x-www-form-urlencoded，携带 token + api + 业务参数。
token 在量脉平台用户中心获取。

如需 Function Calling Schema：将上方链接改为 https://liangmai.pro/agent-skills/functions

网关约定（与 /docs 完全一致）

所有接口统一通过 POST 访问网关，携带 token + api + 业务参数。成功时 JSON 中 code === 0，数据在 data 字段。

POST https://liangmai.pro/api/gateway
Content-Type: application/x-www-form-urlencoded

快速开始

cURL 示例（把 YOUR_TOKEN 换成真实 Token，api 换成目标接口别名）：

curl -sS "https://liangmai.pro/api/gateway" \
  -d "token=YOUR_TOKEN" \
  -d "api=stock_realtime" \
  -d "ts_code=600519"

Python（requests）示例：

import os
import requests

GATEWAY = "https://liangmai.pro/api/gateway"
TOKEN = os.environ.get("LIANGMAI_TOKEN", "YOUR_TOKEN")

r = requests.get(GATEWAY, params={
    "token": TOKEN,
    "api": "stock_realtime",
    "ts_code": "600519",
}, timeout=30)
j = r.json()
# j["code"] == 0 表示成功，j["data"] 为业务数据

建议 Token 从环境变量读取（os.environ["LIANGMAI_TOKEN"]），勿硬编码进可被导出的对话或仓库。

错误与排查

常见 code：401 Token 无效或过期、404 别名未开放、422 缺参、429 限流等，详见开发者文档底部。

若报 TLS、超时或 DNS 错误，请先在本机用同一 URL curl 验证，再检查代理与防火墙。

量脉金融数据平台 · /agent-ai（Agent AI 对接指南）