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.
• Pay as you go: ordering cycles does not charge you upfront. Each cycle is charged at the moment its energy is delegated, so the first charge appears right after the mode is switched on, before your first transfer.
• Cycle price is not a single number: the first two delegations after the mode is switched on are charged at a higher rate, and from the third onward the price follows how much energy your previous transfer actually consumed. The amount returned when you order cycles is an estimate, not the final total.
• Delegation lifetime: 24 rolling hours from the moment energy is delegated. If no transfer happens within that window, the energy is reclaimed, the next cycle is delegated and charged.
• Idle shutdown: after several days without transfers the mode switches itself off and the open orders are closed.
• Bandwidth: a small amount of bandwidth is delegated together with the energy if the address is short of it. It is free and already included in the cycle 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.