研几科技

Appearance

因子数据 ​

查询因子的历史数据记录。

接口 ​

GET /api/v2/data/{factor_agri_id}/

通过因子的 agri_id 查询历史数据。

路径参数 ​

参数类型描述
factor_agri_idstring因子 agri_id，如 d-1000-qyjngeufmfqf-100-00

查询参数 ​

参数类型默认值描述
pageinteger1页码
page_sizeinteger50每页数量

响应示例 ​

json
{
    "success": true,
    "data": {
        "count": 11902,
        "next": "?page=2&page_size=50",
        "previous": null,
        "results": [
            {
                "agri_id": "d-1000-qyjngeufmfqf-100-00",
                "t": 1774150143,
                "value": 74.8,
                "the_type": 100,
                "project_id": "proj_hBonHEAQhm",
                "org_id": "holdingbyte",
                "t_display": "2026-03-22 03:29:03"
            }
        ]
    },
    "error": null
}

响应字段 ​

字段类型描述
countinteger总记录数
nextstring下一页链接
previousstring上一页链接
results[].agri_idstring因子标识符
results[].valuenumber数据值
results[].tinteger时间戳（秒）
results[].t_displaystring格式化时间
results[].the_typeinteger因子类型
results[].project_idstring项目 ID
bash
curl "https://dl.yengear.com/api/v2/data/d-1000-qyjngeufmfqf-100-00/?page=1&page_size=50" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "X-Organization-Slug: your-org-slug"
python
response = requests.get(
    f"{API_BASE}/data/{factor_agri_id}/",
    headers=headers,
    params={"page": 1, "page_size": 50}
)

说明 ​

  • 数据按时间倒序排列
  • 接口缓存：5 分钟
  • t 字段为 UTC 时间戳（秒）

相关文档 ​