# GET /v1/holds

结算冻结列表

最多200条站长冻结记录，按时间倒序，包含证据、裁定状态、七日没收界限和自动解除时间。有效的冻结已从可用余额中扣减。需要`publisher:read`。速率限制等级：`read`。

- 所需权限范围: `publisher:read`
- 速率限制: `read` — 120 次请求/60秒窗口 每个API密钥或网页会话

## 参数

无参数。

## 响应

```
{ amount: string; auto_release_at: string; created_at: string; date_from: string; date_to: string; decided_at: string | null; decision_note: string | null; evidence: string; evidence_data: { cap: string; ivt: object | null; network_report_ref: string | null; reported_deduction: string | null; revenue_publisher: string; revshare_pct: number; suspect_pct: number | null }; forfeit_not_before: string; id: integer; original_amount: string; reason_code: "ivt_suspected" | "network_clawback_pending" | "policy_violation"; status: "active" | "released" | "forfeited"; zone_id: integer | null; zone_name: string | null }[]
```

## 错误

有速率限制的路由会返回`RateLimit-Limit`、`RateLimit-Remaining`和`RateLimit-Reset`（距窗口结束的秒数）；429响应还会带有`Retry-After`。限流器暂时不可用时，这些响应头可能缺失（此时请求会被放行）。

| 状态码 | 含义 |
|---|---|
| 401 | API密钥缺失、无效或已被撤销。 |
| 403 | 该密钥缺少所需的权限范围，或该主体无权执行此操作。 |
| 429 | 已超出速率限制；请等待`Retry-After`秒后重试。 |

HTML文档: https://agimone.com/zh/developers/api/#list-holds
API 2026-10
