列出事件

GET 
/watch/events

事件流：你的地址在最近 90 天内的所有事件，与你的 Webhook 收到的事件相同，最早的在前。

• 追赶进度：发送 since_id（从 0 开始），并在每页之后保存 next_since_id；没有新事件时，它就是你发送的 since_id。
• 确认状态：事件以 finality: "head" 开始，之后变为 solid，极少数情况下变为 reverted。这一变化不会发送 Webhook。使用 updated_since 时，事件流返回确认状态在该时间或之后发生变化的事件：保持 updated_since 不变，并从 0 开始用 since_id 分页。

data 是 Webhook 的 data，与发送时完全相同；事件本身的 finality 为当前值。

请求

Responses

200

成功响应

401

X-API-Key 请求头缺失、无效或已撤销。detail 为纯字符串：API key required、Invalid API key 或 User not found。

403

radar_access_required：该账户既没有 Google 登录，也没有 1 TRX 的已确认净充值；required_deposit_sun 和 allowed_auth_methods 说明如何解锁。API 通用的拒绝同样适用：账户已被封禁（纯字符串 detail）以及 ip_not_allowed。

404

radar_disabled。radar_disabled：此账户无法使用 TRONAgg Radar。

422

invalid_address、invalid_event_type（kind 不是 address.* 事件）、invalid_timestamp（updated_since 未带时区）。请求体或参数类型错误，或请求体中有未知字段时，则返回 FastAPI 的 detail 数组。

429

Rate limit exceeded：你的账户每分钟请求超过 1,000 次（由该账户的所有 API 密钥与工作台会话共用）。detail 为纯字符串；等待 Retry-After 给出的秒数后再重试。

Response Headers

Retry-After

距离限流窗口重置的秒数。