Update an address

PATCH 
/watch/addresses/:address

Change a watched address. Send only what changes:

• label (up to 80 characters) and external_id (up to 128, unique among your watched addresses): an explicit null clears them;
• scenario_id: move the address to another scenario; only USDT that arrives after the move counts toward its threshold;
• status: energy_paused stops Energy purchases (alerts keep working), active resumes them.

Returns the updated address.

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, address_not_found, scenario_not_found. radar_disabled: TRONAgg Radar isn't available for this account.

409

external_id_taken: another watched address uses this external ID; radar_limit_exceeded: the new scenario's limit is full.

422

invalid_address, invalid_label, invalid_external_id, invalid_status, invalid_scenario (scenario_id: null). 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.