Activate Address

POST 
/activate

Activate a TRON address that has never received anything, paid from your balance at the current activation price. Energy and Bandwidth can only be delegated to an activated address; POST /buy activates its receiver on its own (unless activate_address is false), so call this only to activate an address without buying Energy for it.

The current price is activation_fee_sun in GET /estimate?receiver_address= for a receiver that is not activated (receiver_activated: false). The activation usually completes within seconds: poll Get Activation until status is COMPLETED or FAILED. A FAILED activation is refunded to your balance (refunded: true).

If your TRX balance is short and usdt_cover_shortfall is on (see GET /account), just enough of your USDT balance converts to TRX first, as for POST /buy.

Request

Responses

201

The activation was paid and is on its way (PENDING).

400

Activation refused; nothing was charged:

• invalid_address — address is not a valid TRON address
• insufficient_balance — your balance is below the activation price and your USDT could not cover the shortfall (no message; carries current_balance and required_amount in SUN)
• invalid_idempotency_key — Idempotency-Key longer than 128 characters

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

The account is blocked (plain-string detail: Account is blocked), or ip_not_allowed — the request's source IP is outside this key's IP allowlist.

409

Nothing was charged:

• already_activated — the address is already activated; no activation is needed
• activation_in_progress — an activation of this address is already on its way (carries activation_id when it is yours)
• duplicate_request — a request with the same Idempotency-Key is still being processed

422

Request body validation failed (e.g. a missing address or an unknown field) — detail is an array of field errors.

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.

500

internal_error — unexpected error; nothing was charged. Retry later.

503

activation_unavailable — address activation is temporarily unavailable; nothing was charged. Retry later.