Add an address to Host Mode
Registers a TRON address in Host Mode and, optionally, stores a URL for delegation notifications.
A new address is added inactive: switch it on separately through /time/order or /time/infinitystart. If the address is already registered under your account, the call updates its callback_url. The same address cannot be registered under two different accounts.
The infinity flag. With it the address is added and switched straight into infinity mode — the same result as calling /time/add and then /time/infinitystart. But adding and switching on are two separate steps, and only the first is guaranteed. The response reports the result of adding: if the address was added but could not be switched on, you still get the usual code: 0 with the usual message, and the address simply stays inactive. Switching on is skipped when the balance does not cover one cycle at the current price, when the address is already active, and when it already has an open order.
The response is the same with and without the flag — no extra fields, no extra error codes, and it does not tell you whether the mode was actually switched on. Confirm it with /time/status: the address must report status: "active" and mode: "infinity". Do not treat code: 0 from this method as proof that the mode is running.
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.
Request Body
Responses
The normal response of the endpoint. Success is code: 0; an error also arrives with HTTP 200, but with a negative code and data: null. Possible errors (all with code: -1): no key provided, invalid key or non-whitelisted IP, malformed address, rejected callback_url, address owned by another account, temporary database error.