查询历史完整快照
snapshot.list
按日期区间返回可复现的完整发布快照。
调用契约
| 项目 | 值 |
|---|---|
| Method | GET |
| Path | /api/gendangzou/snapshots |
| 业务域 | snapshot |
| 数据更新 | 随完整数据版本发布 |
受控意图：list_snapshots、select_historical_date、compare_history
请求参数
| 参数 | 位置 | 类型 | 必填 | 约束与默认值 |
|---|---|---|---|---|
start | query | string | 否 | 格式 date |
end | query | string | 否 | 格式 date |
page | query | integer | 否 | 从 1 开始的页码；默认 1；最小 1 |
page_size | query | integer | 否 | 默认 50；最小 1；最大 100 |
detail | query | string | 否 | full 保留完整 Web 响应；compact 返回供 Agent 使用的稳定快照引用；默认 full；可选 full、compact |
include | query | string | 否 | 逗号分隔的精简版本扩展：sector_dynamics、coverage；最长 80 字符 |
最小调用
bash
curl --fail --silent --show-error \
-H "Authorization: Bearer $MOBIUSQUANT_TOKEN" \
"https://api.mobiusquant.ai/api/gendangzou/snapshots?page_size=10&detail=compact"响应
| 字段 | 类型 | 必有 | 含义 |
|---|---|---|---|
items | array<SnapshotContext / SnapshotReference> | 是 | 当前查询返回的结果列表。 |
pagination | Pagination | 是 | 分页位置、总数和总页数。 |
调用要点
- 以响应中的实际
snapshot_id和as_of作为版本依据。 - Agent 建议使用
detail=compact控制上下文体积。 - 分页从
page_size=10开始，确认需要后再继续翻页。