Host Mode - Continuous Energy Management

Host Mode is an automated energy-management system that keeps a TRON address supplied with energy for USDT (TRC-20) transfers, delegating energy for each cycle and re-delegating automatically after the address consumes it.

Overview

Once an address is in Host Mode, the system delegates energy to it and watches the address for USDT transfers. After a transfer consumes the delegated energy, the energy is reclaimed and a new cycle is delegated automatically — as long as the address has cycles left (or is in infinity mode).

Key Features

• Automatic energy: energy is delegated for each cycle without manual action
• Auto re-delegation: after a USDT transfer consumes energy, the next cycle is delegated automatically
• Cycle system: you pay per delegation cycle
• Infinity mode: continuous operation until you stop it

How It Works

1. Add address: register the address in Host Mode (/apiv2/time/add).
2. Buy cycles: order a fixed number of cycles (/apiv2/time/order) or enable infinity mode (/apiv2/time/infinitystart). This activates the address.
3. Delegation: energy is delegated to the address for the current cycle.
4. Usage: when the address makes a USDT transfer and consumes the energy, the system reclaims it and delegates the next cycle.
5. Completion: when all ordered cycles are used, the address is stopped automatically. In infinity mode it keeps running until you stop it.

Cycle System

• 1 cycle = 1 delegation: each energy delegation consumes one cycle.
• Cycle price: taken from the current public price table; the amount charged is cycles × price.
• Infinity mode: cycles are effectively unlimited until you stop the address.

Good Fit For

• Active traders making frequent USDT transfers
• Users who do not stake TRX for their own energy
• Services that need energy available on an address without manual top-ups

Management Endpoints

• Time Add — add an address to Host Mode (and register a callback URL)
• Time Order — buy a specific number of cycles (activates the address)
• Time Infinity Start — enable infinity (unlimited) mode
• Time Stop — stop Host Mode and close open orders
• Time Delete — remove an address from Host Mode
• Time Status — check addresses, modes and cycle counts

Authentication

Every request requires:

1. API key — passed in the JSON body (api_key) or the X-API-KEY header.
2. Whitelisted IP — the request IP must be in the whitelist configured for your API key.

All endpoints return a JSON envelope:

{ "code": 0, "msg": "…", "data": { } }

code = 0 means success; a negative code means an error (see msg).

Callbacks (webhooks)

When you register a callback_url for an address (via /apiv2/time/add), the system notifies your URL each time energy is delegated to that address. See Time Add → Callbacks for the exact request format.

Best Practices

1. Verify the address is correct and activated on the TRON network before adding it.
2. Keep enough balance to cover the cycles you order.
3. Start small with a few cycles before enabling infinity mode.
4. Monitor your addresses and cycle counts with the Time Status endpoint.
5. Protect your API key — never expose it in client-side code; keep your IP whitelist up to date.

Getting Started

1. Obtain an API key and whitelist your server IP.
2. Add the address with /apiv2/time/add.
3. Order cycles with /apiv2/time/order or enable infinity mode with /apiv2/time/infinitystart.
4. Monitor status with /apiv2/time/status.