API 文档

标准 RESTful 接口,5 分钟快速集成,为量化策略提供稳定的因子数据

https://xingshucloud.com/api/factors/

1快速开始

所有接口均为 GET 请求(除重新加载为 POST),返回 JSON 格式,支持跨域(CORS 已开启)。

订阅后获得专属 API Key,调用时通过请求头携带:

# 请求头示例
X-API-Key: your-api-key-here
💡 试用账号可使用基础接口(/coarse)预览数据,无需 API Key; 完整因子库(/fine、/orthogonal)需订阅后使用。

2产品层级总览

因子数据按质量等级分为四个层级,对应不同订阅方案:

GET /api/factors/products 产品层级列表
层级数量说明对应方案
raw425原料库(21 座矿原始产出)—
coarse141IC 粗筛(IC≥0.02)基础版
fine66IC 细筛(IC≥0.03 且 ICIR≥0.3)标准版
orthogonal145正交化(去共线性,生产就绪)企业版

3因子查询接口

GET /api/factors/coarse IC 粗筛因子(基础版)

返回前 20 个因子,支持 ?limit= 控制数量(最大 141):

# Python 示例
import requests
r = requests.get("https://xingshucloud.com/api/factors/coarse",
                 params={"limit": 50})
data = r.json()
for f in data["factors"]:
    print(f["name"], f["ic"], f["icir"])
GET /api/factors/fine IC 细筛因子(标准版)

IC≥0.03 且 ICIR≥0.3,经过多重验证的高质量因子,共 66 个。参数同 coarse。

GET /api/factors/orthogonal 正交化因子(企业版)

去共线性后的 145 个独立因子,生产就绪,适合直接用于多因子组合。

GET /api/factors/raw 原料库(全部因子)

21 座矿原始产出共 425 个候选因子,适合有独立筛选能力的团队做二次挖掘。

4统计与管理

GET /api/factors/stats 因子库统计信息
{
  "raw": 425,
  "coarse": 141,
  "fine": 66,
  "orthogonal": 145,
  "with_ic": 3
}
POST /api/factors/reload 重新加载数据(管理用)

因子数据文件更新后调用,无需重启服务。需要管理权限。

🔒 限流说明:基础版 10 万次/月、标准版 50 万次/月;超限自动熔断,次月恢复。

5错误码

HTTP 状态码含义处理建议
200成功—
401未授权 / API Key 无效检查请求头 X-API-Key
403无权限访问该层级升级订阅方案
429请求超限等待限流恢复或升级方案
500服务内部错误联系技术支持

6需要帮助?

商务合作:contact@daxdec.com · 技术支持微信:xingshucloud

查看定价方案 →