---
title: "获取最新完整快照"
description: "获取最新快照，或指定日期之前最近的完整快照。"
pageClass: gendangzou-doc
---

# 获取最新完整快照

`snapshot.latest`

获取最新快照，或指定日期之前最近的完整快照。

## 调用契约

| 项目 | 值 |
| --- | --- |
| Method | `GET` |
| Path | `/api/gendangzou/snapshots/latest` |
| 业务域 | `snapshot` |
| 数据更新 | 随完整数据版本发布 |

受控意图：`get_latest_snapshot`、`get_version_context`

## 请求参数

| 参数 | 位置 | 类型 | 必填 | 约束与默认值 |
| --- | --- | --- | --- | --- |
| `as_of` | query | string | 否 | 返回此日期或此前最近的完整快照；格式 `date` |
| `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/latest?detail=compact"
```



## 响应

| 字段 | 类型 | 必有 | 含义 |
| --- | --- | --- | --- |
| `snapshot` | `SnapshotContext / SnapshotReference` | 是 | 本次查询实际使用的数据版本。 |

## 调用要点

- 以响应中的实际 `snapshot_id` 和 `as_of` 作为版本依据。
- Agent 建议使用 `detail=compact` 控制上下文体积。

## 关联能力

- [`snapshot.list`](/zh/gendangzou/capabilities/snapshot.list)
- [`signal.heat.rank`](/zh/gendangzou/capabilities/signal.heat.rank)
- [`signal.dynamics.list`](/zh/gendangzou/capabilities/signal.dynamics.list)

## 机器可读契约

- [完整能力清单](/zh/gendangzou/agent-manifest.json)
- [在线能力详情](https://api.mobiusquant.ai/api/gendangzou/capabilities/snapshot.latest)