List events

GET 
/watch/events

The event feed: every event of your addresses from the last 90 days, the same events your webhooks receive, oldest first.

• Catch up: send since_id (start with 0) and store next_since_id after each page; it's the since_id you sent when there's nothing new.
• Finality: events start as finality: "head" and turn solid, or rarely reverted. No webhook is sent for that. With updated_since, the feed returns events whose finality changed at or after that time: keep updated_since fixed and page with since_id from 0.

data is the webhook data, exactly as it was sent; the event's own finality is the current one.

Request

Responses

200

Successful Response

401

The X-API-Key header is missing, invalid or revoked. detail is a plain string: API key required, Invalid API key or User not found.

403

radar_access_required: the account has neither a Google sign-in nor 1 TRX of net confirmed deposits; required_deposit_sun and allowed_auth_methods say what unlocks it. The API-wide refusals also apply: a blocked account (plain-string detail) and ip_not_allowed.

404

radar_disabled. radar_disabled: TRONAgg Radar isn't available for this account.

422

invalid_address, invalid_event_type (kind isn't an address.* event), invalid_timestamp (updated_since without a time zone). A body or parameter of the wrong type, or an unknown body field, returns FastAPI's detail array instead.

429

Rate limit exceeded: more than 1,000 requests per minute for your account (shared by all of its API keys and workspace sessions). detail is a plain string; wait the number of seconds in Retry-After, then retry.

Response Headers

Retry-After

Seconds until the rate-limit window resets.