Host Mode - Quản lý Energy liên tục

Host Mode là một hệ thống quản lý energy tự động giúp duy trì nguồn cung cấp energy cho một địa chỉ TRON để thực hiện các giao dịch chuyển USDT (TRC-20), ủy quyền energy cho từng chu kỳ và tự động ủy quyền lại sau khi địa chỉ tiêu thụ hết.

Tổng quan

Khi một địa chỉ ở trong Host Mode, hệ thống sẽ ủy quyền energy cho địa chỉ đó và theo dõi các giao dịch chuyển USDT của địa chỉ. Sau khi một giao dịch chuyển tiêu thụ hết energy đã ủy quyền, energy sẽ được thu hồi và một chu kỳ mới sẽ được ủy quyền tự động — miễn là địa chỉ đó vẫn còn chu kỳ (hoặc đang ở chế độ infinity mode).

Các tính năng chính

• Energy tự động: energy được ủy quyền cho từng chu kỳ mà không cần thao tác thủ công
• Tự động ủy quyền lại: sau khi giao dịch chuyển USDT tiêu thụ energy, chu kỳ tiếp theo sẽ được ủy quyền tự động
• Hệ thống chu kỳ: bạn trả phí theo từng chu kỳ ủy quyền
• Chế độ infinity mode: hoạt động liên tục cho đến khi bạn dừng lại

Cách thức hoạt động

1. Thêm địa chỉ: đăng ký địa chỉ trong Host Mode (/apiv2/time/add).
2. Mua chu kỳ: đặt mua một số lượng chu kỳ cố định (/apiv2/time/order) hoặc bật chế độ infinity mode (/apiv2/time/infinitystart). Thao tác này sẽ kích hoạt địa chỉ.
3. Ủy quyền: energy được ủy quyền cho địa chỉ trong chu kỳ hiện tại.
4. Sử dụng: khi địa chỉ thực hiện giao dịch chuyển USDT và tiêu thụ energy, hệ thống sẽ thu hồi energy đó và ủy quyền chu kỳ tiếp theo.
5. Hoàn tất: khi tất cả các chu kỳ đã đặt mua được sử dụng hết, địa chỉ sẽ tự động dừng lại. Ở chế độ infinity mode, nó sẽ tiếp tục chạy cho đến khi bạn dừng lại.

Chu kỳ và Giá cả

• 1 chu kỳ = 1 lần ủy quyền: mỗi lần ủy quyền là 131.000 energy và tiêu tốn một chu kỳ.
• Thanh toán theo mức sử dụng: việc đặt mua các chu kỳ không tính phí trước. Mỗi chu kỳ được tính phí tại thời điểm energy của chu kỳ đó được ủy quyền, vì vậy khoản phí đầu tiên sẽ xuất hiện ngay sau khi chế độ được bật, trước giao dịch chuyển đầu tiên của bạn.
• Giá chu kỳ: lần ủy quyền đầu tiên của một đợt kích hoạt có giá 4 TRX. Mỗi lần tiếp theo có giá 2 TRX nếu giao dịch chuyển trước đó của bạn tiêu thụ từ 65.000 energy trở xuống, và 4 TRX nếu tiêu thụ nhiều hơn mức đó. Đợt kích hoạt là khoảng thời gian bắt đầu khi một địa chỉ không có đơn hàng mở và không có ủy quyền đang hoạt động được bật lên. Mua thêm chu kỳ khi địa chỉ đang chạy sẽ tiếp tục cùng một đợt kích hoạt đó. Việc dừng địa chỉ sẽ kết thúc đợt kích hoạt — bật lại địa chỉ và lượt đếm sẽ bắt đầu lại từ đầu, do đó lần ủy quyền đầu tiên đó sẽ lại là 4 TRX. Giá trị amount được trả về khi bạn đặt mua chu kỳ là ước tính, không phải là tổng chi phí cuối cùng.
• Mức tối thiểu hàng ngày (có hiệu lực từ 2026-08-29): mỗi địa chỉ bị trừ ít nhất 8 TRX cho mỗi ngày theo lịch UTC. Nếu bị trừ ít hơn, phần chênh lệch sẽ bị trừ ngay sau khi ngày kết thúc. Xem Mức tối thiểu hàng ngày để biết những gì được tính, ví dụ và các ngoại lệ.
• Thời hạn ủy quyền: 24 giờ liên tục tính từ thời điểm energy được ủy quyền. Nếu không có giao dịch chuyển nào xảy ra trong khoảng thời gian đó, energy sẽ bị thu hồi, chu kỳ tiếp theo sẽ được ủy quyền cho ngày tiếp theo và tính phí theo mức 4 TRX.
• Tắt khi không hoạt động: sau 2 ngày liên tiếp không hoạt động — hai chu kỳ 24 giờ kết thúc mà không có giao dịch chuyển nào — chế độ sẽ tự động tắt và các đơn hàng đang mở sẽ bị đóng.
• Giao dịch chuyển bổ sung trong một chu kỳ đã thanh toán: giao dịch chuyển thứ hai được gửi trong vài giây trước khi energy bị thu hồi sẽ tái sử dụng chính energy đó. Nó không bắt đầu một chu kỳ mới và không làm giảm số chu kỳ còn lại của bạn, nhưng nó sẽ được tính phí riêng theo mức phí tương ứng với lượng energy đã tiêu thụ. Hãy để khoảng cách khoảng một phút giữa các giao dịch chuyển để tránh điều này.
• Bandwidth: tối đa 400 bandwidth được ủy quyền cùng với energy nếu địa chỉ bị thiếu. Phần này miễn phí và đã được bao gồm trong giá chu kỳ.
• Chế độ infinity mode: các chu kỳ về cơ bản là không giới hạn cho đến khi bạn dừng địa chỉ. Mọi điều khoản ở trên vẫn được áp dụng — mỗi lần ủy quyền được tính phí khi nó diễn ra, đồng thời mức tối thiểu hàng ngày và việc tắt khi không hoạt động cũng vận hành tương tự.

Mức tối thiểu hàng ngày

Mỗi địa chỉ bật Host Mode phải bị trừ ít nhất 8 TRX cho mỗi ngày theo lịch UTC (00:00–24:00 UTC). Quy định áp dụng cho các ngày từ 2026-08-29 trở đi.

• Khi nào: ngày được quyết toán ngay sau khi kết thúc, vào khoảng 00:05 UTC. Nếu trong ngày đó địa chỉ bị trừ ít hơn 8 TRX, phần chênh lệch sẽ bị trừ vào lúc này.
• Những gì được tính vào 8 TRX: mọi khoản đã trừ cho địa chỉ trong ngày đó — các chu kỳ, kể cả chu kỳ nhàn rỗi (chu kỳ được ủy quyền cho ngày hôm sau khi không có giao dịch chuyển, 4 TRX), và phí cho giao dịch chuyển bổ sung trong một chu kỳ đã thanh toán. Một khoản trừ được tính vào ngày nó được thực hiện.
• Theo từng địa chỉ, mỗi ngày một lần: mức tối thiểu được kiểm tra riêng cho từng địa chỉ — một tài khoản có năm địa chỉ sẽ có năm lần kiểm tra. Mỗi địa chỉ bị trừ bù tối đa một lần mỗi ngày.

Ví dụ (giá chu kỳ 4 TRX và 2 TRX):

Đã trừ trong ngày UTC	Tổng	Trừ bù sau khi hết ngày
Không có	0 TRX	8 TRX
1 chu kỳ 4 TRX	4 TRX	4 TRX
2 chu kỳ 2 TRX	4 TRX	4 TRX
2 chu kỳ 4 TRX	8 TRX	không
3 chu kỳ 2 TRX	6 TRX	không — 3 lần trừ

Ngoại lệ — ngày đó không bị trừ bù khi:

• địa chỉ có từ 3 lần trừ tiền trở lên trong ngày, bất kể tổng số tiền. Chu kỳ nhàn rỗi cũng được tính là lần trừ tiền;
• đó là ngày bật chế độ và chế độ được bật lúc 16:00 UTC hoặc muộn hơn. Mức tối thiểu áp dụng từ ngày hôm sau. Bật lúc 15:59 UTC — mức tối thiểu đầy đủ áp dụng cho ngày đó.

Không đủ số dư: khoản trừ bù được trừ toàn bộ hoặc không trừ. Nếu số dư của bạn thấp hơn khoản trừ bù, Host Mode của địa chỉ sẽ tắt: các đơn hàng đang mở bị đóng và callback host_paused được gửi với lý do no_balance. Ví dụ, với 3 TRX trong số dư và khoản trừ bù 4 TRX, địa chỉ sẽ bị tắt. Hãy duy trì đủ số dư để trang trải mức tối thiểu.

Tài khoản con của đối tác: các khoản trừ từ tài khoản con đã bao gồm phần chênh giá của đối tác và được tính vào 8 TRX của tài khoản đó. Bản thân khoản trừ bù không có phần chênh giá.

Phù hợp cho

• Các nhà giao dịch tích cực thực hiện chuyển USDT thường xuyên
• Người dùng không stake TRX để lấy energy cho riêng mình
• Các dịch vụ cần energy luôn có sẵn trên địa chỉ mà không cần nạp thủ công

Các Endpoint quản lý

• Time Add — thêm một địa chỉ vào Host Mode (và đăng ký một callback URL)
• Time Order — mua một số lượng chu kỳ cụ thể (kích hoạt địa chỉ)
• Time Infinity Start — bật chế độ infinity (không giới hạn)
• Time Stop — dừng Host Mode và đóng các đơn hàng đang mở
• Time Delete — xóa một địa chỉ khỏi Host Mode
• Time Status — kiểm tra địa chỉ, chế độ và số lượng chu kỳ

Xác thực

Mỗi yêu cầu đều cần có:

1. API key — được truyền trong JSON body (api_key) hoặc header X-API-KEY.
2. IP trong danh sách trắng — IP của yêu cầu phải nằm trong danh sách trắng được cấu hình cho API key của bạn.

Tất cả các endpoint đều trả về một cấu trúc JSON:

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

code = 0 nghĩa là thành công; code mang giá trị âm nghĩa là có lỗi (xem msg).

Callback (webhook)

Khi bạn đăng ký một callback_url cho một địa chỉ (thông qua /apiv2/time/add), hệ thống sẽ thông báo tới URL của bạn mỗi khi energy được ủy quyền cho địa chỉ đó. Callback mang theo hash ủy quyền, số tiền bị trừ cho chu kỳ (charged, TRX, luôn xuất hiện) và — chỉ khi chu kỳ được tạo ra từ giao dịch chuyển của bạn — mức biểu phí tiêu thụ energy của giao dịch chuyển đó (energy_used: 65k hoặc 131k, nếu không tham số này sẽ được bỏ qua). Xem Time Add → Callbacks để biết định dạng yêu cầu chính xác.

Thực hành tốt nhất

1. Xác minh địa chỉ là chính xác và đã được kích hoạt trên mạng lưới TRON trước khi thêm vào.
2. Duy trì đủ số dư — các chu kỳ được tính phí khi chúng được ủy quyền, không phải khi bạn đặt mua.
3. Bắt đầu với quy mô nhỏ cùng một vài chu kỳ trước khi bật chế độ infinity mode.
4. Theo dõi địa chỉ, số lượng chu kỳ và mức chi tiêu thực tế của bạn bằng endpoint Time Status.
5. Để khoảng cách khoảng một phút giữa các giao dịch chuyển từ cùng một địa chỉ, để giao dịch thứ hai không tái sử dụng energy đang trong quá trình bị thu hồi.
6. Dừng các địa chỉ bạn không sử dụng — một địa chỉ không hoạt động vẫn tốn mức phí tối thiểu hàng ngày cho đến khi nó tự tắt.
7. Bảo vệ API key của bạn — không bao giờ để lộ API key trong mã nguồn phía client; luôn cập nhật danh sách trắng IP của bạn.

Bắt đầu

1. Lấy một API key và đưa IP máy chủ của bạn vào danh sách trắng.
2. Thêm địa chỉ bằng /apiv2/time/add.
3. Đặt mua chu kỳ bằng /apiv2/time/order hoặc bật chế độ infinity mode bằng /apiv2/time/infinitystart.
4. Theo dõi trạng thái bằng /apiv2/time/status.