API DOCS
实时 API 接口
通过 API KEY 调用最新的因子值与大模型信号，覆盖个人、机构与学术研究等场景。建议在 PC 端阅读本文档。
概览
所有 API 走 HTTPS，基础地址为 https://api.deepemerge.cn。
通过 API 可获取的内容包括：7 类因子的最新值与历史值、大模型对大盘 / 个股的实时打分（限黑钻会员）、回测预计算结果等。
鉴权
所有请求需在 HTTP Header 中携带 API KEY：
Authorization: Bearer <YOUR_API_KEY>请勿将 KEY 暴露在前端代码或公开仓库中。如怀疑泄露请尽快联系客服重置。
速率限制
每个 API KEY 默认每分钟可请求 120 次。如有更高吞吐需求，可在开通会员时与客服协商提升上限。
触发限流时返回 HTTP 429，响应头 X-RateLimit-Remaining 会随每次请求返回剩余配额。
端点列表
按因子类型规划独立端点，统一的查询参数（start_date / end_date / codes）与响应结构。
| 因子 | 端点 | 所需会员 |
|---|---|---|
| 大模型择时因子 | GET /v1/factors/timing-llm | 白金 及以上 |
| 大模型个股因子 | GET /v1/factors/stock-llm | 钻石 及以上 |
| 大模型量价因子 | GET /v1/factors/pv-llm | 白金 及以上 |
| 101 因子 | GET /v1/factors/alpha101 | 白金 及以上 |
| 158 因子 | GET /v1/factors/alpha158 | 白金 及以上 |
| 财务因子 | GET /v1/factors/financial | 白金 及以上 |
| 资金流向因子 | GET /v1/factors/moneyflow | 黄金 及以上 |
调用示例
以「大模型择时因子」为例：
curl
curl -X GET "https://api.deepemerge.cn/v1/factors/timing-llm?start_date=2025-12-01&end_date=2025-12-31" \
-H "Authorization: Bearer YOUR_API_KEY"Python
import requests
resp = requests.get(
"https://api.deepemerge.cn/v1/factors/timing-llm",
params={"start_date": "2025-12-01", "end_date": "2025-12-31"},
headers={"Authorization": "Bearer YOUR_API_KEY"},
timeout=10,
)
data = resp.json()
print(data["items"][:3])响应示例
{
"factor": "timing-llm",
"items": [
{"year": 2025, "month": 12, "day": 3, "hour": 14, "md_score": 245.6493},
{"year": 2025, "month": 12, "day": 4, "hour": 14, "md_score": -76.1209}
],
"request_id": "..."
}错误码
| HTTP | 含义 | 处理建议 |
|---|---|---|
| 401 | KEY 缺失或无效 | 检查 Authorization Header |
| 403 | 会员权限不足 | 升级到对应会员档 |
| 429 | 超出每分钟请求限制 | 退避后重试 |
| 5xx | 服务异常 | 联系客服或稍后重试 |
申请 API KEY
提供两种申请方式，按需选择：
- 填写表单（电话 / 微信 / 名字）后客服线下确认
- 直接扫码加企微，由客服为您开通