Activate a TRON address
Creates the account record for an address that has never been used on-chain. Until an address is activated, energy and bandwidth cannot be delegated to it.
The operation is one-time per address and costs a fixed 1.1 TRX. You are charged at the moment of a successful activation; a failed attempt costs nothing. If the address is already active, code 2001 is returned and nothing is charged — check detail.code before assuming money was spent.
The 1-hour energy order activates an inactive address on its own and includes the activation in the order cost. Call this endpoint explicitly when the address must become active BEFORE a rental — for example before ordering bandwidth, which requires an active account.
The address becomes usable only once the transaction is included in a block, up to ~3 seconds after the response. If your next step depends on the address being active, confirm its state on-chain by the returned hash instead of calling the next method immediately.
There is no idempotency. Repeating the call for an already active address is safe and free, but two simultaneous requests for the same new address may both proceed — serialise activation on your side.
The legacy path /apiv2/activation is served by the same service and behaves identically.
Authorizations
API key from the dashboard. Some Host Mode endpoints also accept the key as an api_key field in the request body — this is stated in the schema of the particular operation.
Parameters
Header Parameters
An IP address from the key's whitelist. A request from an address outside the whitelist is rejected with 401.
"203.0.113.10""ipv4"Request Body
Responses
The address was activated (10000, 1.1 TRX charged) or was already active (2001, nothing charged).