数据 API
数据 API: 周期状态、关键位、期权结构与宏观数据
澄澜量化提供只读 JSON 的股票数据 API, 覆盖网页端能看到的全部公开数据: 美股、港股、A股、加密货币与大宗商品的价格周期状态、关键位与每日状态变化, 美股期权数据(期权墙、最大痛点、GEX), 宏观数据(美债收益率、期限利差、VIX 等), 以及新闻、SEC 内部人交易与做空数据。在用户中心生成 Key 即可调用, 附 OpenAPI 3.0 文档。
接口一览
| 接口(GET) | 内容 |
|---|---|
/api/v1/meta | 数据版本: 引擎版本、生成时间、各市场最新交易日 |
/api/v1/markets | 市场周期宽度: 各市场大趋势 / 阶段 / 周期态分布与主要指数 |
/api/v1/list | 标的列表: 按市场、大趋势、阶段、周期态筛选, 排序与分页 |
/api/v1/symbol/{sym} | 单个标的摘要: 状态、关键位、最近变化、宏观敏感度 |
/api/v1/analysis/{sym} | 单个标的完整结论: 白话解读、关键位及距离、期权结构、宏观敏感度(支持 Markdown) |
/api/v1/daily | 每日市场周期日报: 按市场分板块的宽度、重点状态变化与同日关联事件、观察位、未来日历(中文 / 英文, 支持 Markdown) |
/api/v1/weekly | 每周周报: 一周的宽度变化、重点状态变化与板块聚集 |
/api/v1/batch | 批量摘要 |
/api/v1/search | 搜索 |
/api/v1/changes | 状态变化(异动), 支持按日期增量同步 |
/api/v1/chart/{sym} | 图表数据: 日 K、周线关键位、大趋势 / 阶段序列与全部标记 |
/api/v1/ext/{sym} | 个股事件: 财报、期权墙与期权结构 |
/api/v1/macro/dashboard | 宏观仪表盘 |
/api/v1/macro/series/{key} | 宏观序列历史 |
/api/v1/calendar | 宏观与财报日历 |
/api/v1/news/{sym} | 个股新闻 |
/api/v1/sec/{sym} | SEC 内部人交易与发债备案(美股) |
/api/v1/short/{sym} | 做空成交量(美股) |
完整参数、字段说明与示例见 API 文档(可下载 Markdown 与 OpenAPI 3.0 JSON)。
AI 接入: MCP 与 Skill
澄澜量化提供 MCP 服务, Claude、ChatGPT、Codex、Cursor 等 AI 助手可以直接调用已经算好的周期结论(趋势、关键位、期权墙、市场宽度、每日 / 每周日报), 不用自己拿 K 线重算。
- 在应用的「用户中心 → API」生成 Key(不带 Key 也能试用, 按 IP 限速)。
- 在 AI 客户端添加远程 MCP: 地址
https://app.chenglanai.com/mcp, 传输方式 Streamable HTTP, 请求头Authorization: Bearer 你的 Key。 - 可选: 下载 SKILL.md 放到
~/.claude/skills/chenglanai/或~/.codex/skills/chenglanai/, 让 AI 知道什么问题调哪个工具、引用时注明数据日期。 - 直接提问, 例如「英伟达现在是什么趋势? 上方压力在哪」「今天美股发生了什么」。
# Claude Code
claude mcp add --transport http chenglanai https://app.chenglanai.com/mcp --header "Authorization: Bearer $CHENGLAN_API_KEY"
# Codex: ~/.codex/config.toml
[mcp_servers.chenglanai]
url = "https://app.chenglanai.com/mcp"
bearer_token_env_var = "CHENGLAN_API_KEY"Cursor 等其他客户端的配置与全部工具说明见 API 文档 · AI 接入。工具调用与 HTTP API 共用同一个 Key 的额度; 返回内容只描述状态, 不构成投资建议。
认证与额度
- 在应用的「用户中心 → API」生成 Key(会员功能), 请求头带
Authorization: Bearer cl_live_xxx(也可用X-API-Key)。 - 每个 Key 默认每日 5,000 次调用, 北京时间 0 点重置; 响应头
X-RateLimit-Remaining显示剩余额度。合作方可申请不限额的服务级 Key(可绑定来源 IP)。 - 所有接口只读、返回 JSON, 支持 gzip 与跨域; 数据按各市场收盘后发布, 可用
/api/v1/meta判断是否已更新。 - 返回内容为价格周期状态的客观描述, 不构成投资建议。
示例
import requests
r = requests.get("https://app.chenglanai.com/api/v1/list",
params={"mkt": "US", "bt": 1, "sort": "chg20", "limit": 50},
headers={"Authorization": "Bearer cl_live_xxx"})
for row in r.json()["rows"]:
print(row["sym"], row["name"], row["rg"], row["lv"]["mid"])常用字段: bt 大趋势(1 上涨 / -1 下跌 / 0 未定), bp 待确认(1 / -1 / 0), st 阶段, rg 周线周期态, lv 关键位(mid / up / dn 周布林中上下轨, e120 / e250 周 EMA, tl 下降趋势线), pos 周布林带位置, last 最近一次状态变化。
适合用来做什么
- 量化研究: 把周期状态作为特征或过滤条件
- 看板与选股器: 按大趋势、阶段批量筛选
- 内容制作: 每日复盘、周报与视频的数据来源
- 交易终端: 在自己的图表上叠加关键位与期权墙
常见问题
API 收费吗?
API Key 为会员功能, 在用户中心生成; 默认每日 5,000 次调用。需要更高额度可联系客服。
数据多久更新?
各市场收盘后计算发布, 非实时。用 /api/v1/meta 的 generated 与 asof 字段判断是否已更新。
有 OpenAPI 文档吗?
有。API 文档页可下载 OpenAPI 3.0 JSON 与 Markdown, 可直接导入 Postman 或用来生成客户端。
能在 Claude / ChatGPT / Cursor 里用吗?
可以。添加远程 MCP 服务 https://app.chenglanai.com/mcp(请求头带 API Key), 再安装 SKILL.md, AI 就能直接调用澄澜的周期结论与日报。