POST /apiv2/time/infinitystart

Bật chế độ infinity (không giới hạn) cho một địa chỉ đã ở trong Host Mode — Energy tiếp tục được ủy quyền hết chu kỳ này sang chu kỳ khác cho đến khi bạn dừng lại.

URL Điểm cuối

POST https://netts.io/apiv2/time/infinitystart

Xác thực

Cung cấp API key của bạn trong phần thân yêu cầu (api_key) hoặc tiêu đề X-API-KEY. IP yêu cầu phải nằm trong danh sách trắng được định cấu hình cho API key của bạn.

Thân Yêu cầu

{
    "api_key": "your_api_key",
    "address": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE"
}

Tham số

Tham số	Loại	Bắt buộc	Mô tả
api_key	string	Có	API key (hoặc tiêu đề X-API-KEY).
address	string	Có	Địa chỉ TRON (TRC-20), ^T[1-9A-HJ-NP-Za-km-z]{33}$. Địa chỉ phải đang ở trong Host Mode (thêm nó trước).

Hành vi

• Địa chỉ phải đã tồn tại trong Host Mode và đang ở trạng thái không hoạt động (đã dừng).
• Số dư của bạn phải đủ để chi trả ít nhất một chu kỳ theo mức giá hiện tại (được kiểm tra trước khi kích hoạt).
• Điểm cuối này kích hoạt địa chỉ, tạo một đơn hàng infinity đang mở, và Host Mode sẽ tiếp tục ủy quyền Energy hết chu kỳ này sang chu kỳ khác cho đến khi bạn gọi /apiv2/time/stop.

Các chu kỳ được tính phí khi chúng được ủy quyền (một chu kỳ cho mỗi lần ủy quyền). 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 hoặc 4 TRX tùy thuộc vào lượng Energy mà giao dịch chuyển tiền trước đó của bạn thực tế đã tiêu thụ (≤ 65.000 → 2 TRX, nhiều hơn → 4 TRX). Mức tối thiểu hàng ngày 8 TRX (có hiệu lực từ ngày 2026-08-29) và việc tự động tắt sau 2 ngày không hoạt động cũng được áp dụng trong chế độ infinity — xem Host Mode → Chu kỳ và Giá cả.

Trong Time Status, một địa chỉ infinity sẽ báo cáo cycles_ordered và cycles_remaining là null — không có giới hạn nào để đếm ngược. Hãy hiểu null là "không giới hạn", không phải là "hết chu kỳ".

Ví dụ Yêu cầu

cURL

curl -X POST https://netts.io/apiv2/time/infinitystart \
  -H "Content-Type: application/json" \
  -d '{
    "api_key": "YOUR_API_KEY_HERE",
    "address": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE"
  }'

Python

import requests

resp = requests.post(
    "https://netts.io/apiv2/time/infinitystart",
    json={"api_key": "YOUR_API_KEY_HERE", "address": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE"},
    timeout=30,
)
result = resp.json()

if result["code"] == 0:
    print("Infinity mode active, order:", result["data"]["order_id"])
else:
    print("Error:", result["msg"])

Node.js

const axios = require('axios');

axios.post('https://netts.io/apiv2/time/infinitystart', {
    api_key: 'YOUR_API_KEY_HERE',
    address: 'TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE',
}).then(({ data: result }) => {
    if (result.code === 0) console.log('Infinity mode active, order:', result.data.order_id);
    else console.error('Error:', result.msg);
}).catch(err => console.error('Request failed:', err.response?.data || err.message));

Phản hồi

Thành công (200 OK)

{
    "code": 0,
    "msg": "Infinity mode activated successfully",
    "data": {
        "address": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
        "order_id": 5427,
        "mode": "infinity",
        "status": "active",
        "timestamp": "2026-07-13T05:30:15.123456"
    }
}

Các trường Phản hồi

Trường	Loại	Mô tả
code	integer	0 = thành công, số âm = lỗi
msg	string	Thông báo thân thiện với người dùng
data.address	string	Địa chỉ được kích hoạt ở chế độ infinity
data.order_id	integer	Mã định danh đơn hàng nội bộ
data.mode	string	"infinity"
data.status	string	"active"
data.timestamp	string	Dấu thời gian ISO

Phản hồi Lỗi

code	msg	Nguyên nhân
-1	API key required in X-API-KEY header or request body	Chưa cung cấp API key
-1	Invalid API key or IP not in whitelist	Xác thực thất bại
-1	Invalid TRC-20 address format	Định dạng địa chỉ không hợp lệ
-1	Failed to activate host mode	Không thể kích hoạt địa chỉ — hãy thử lại
-1	Database error activating infinity mode	Lỗi máy chủ tạm thời — hãy thử lại
-1	Internal server error	Lỗi không mong muốn — hãy thử lại hoặc liên hệ bộ phận hỗ trợ
-2	Insufficient balance. Required: X TRX, Available: Y TRX	Số dư thấp hơn giá của một chu kỳ
-4	Address not found. Please add address first	Địa chỉ không có trong Host Mode
-5	Host mode is already active for this address	Địa chỉ đang chạy rồi
-6	There is already an open order for this address	Đã tồn tại một đơn hàng đang mở

{ "code": -4, "msg": "Address not found. Please add address first", "data": null }

Mã trạng thái HTTP

Các lỗi của điểm cuối được trả về với HTTP 200 và một code âm — hãy kiểm tra code, không phải trạng thái HTTP. Phần thân lỗi luôn bao gồm "data": null.

Một số lỗi được trả về trước khi yêu cầu đến được điểm cuối. Chúng sử dụng trạng thái khác 200 và cấu trúc phần thân khác:

HTTP	Thân	Nguyên nhân
402	{"detail": {"code": 1004, "msg": "Insufficient funds. Minimum balance is 4 TRX. Please top up your account."}}	Số dư tài khoản quá thấp
403	{"detail": {"code": 1005, "msg": "API key is blocked. Contact support."}}	API key bị khóa — liên hệ bộ phận hỗ trợ
422	{"detail": [ … ]}	Phần thân yêu cầu không qua được xác thực: thiếu trường bắt buộc hoặc sai loại dữ liệu. Lưu ý rằng không có trường code trong phản hồi này

Điểm cuối Liên quan

• POST /apiv2/time/add — thêm địa chỉ trước
• POST /apiv2/time/order — mua số lượng chu kỳ cố định thay thế
• POST /apiv2/time/stop — dừng chế độ infinity
• POST /apiv2/time/status — kiểm tra trạng thái

Ghi chú

• Chế độ infinity chạy cho đến khi bạn dừng nó bằng /apiv2/time/stop.
• Duy trì đủ số dư khả dụng — các chu kỳ được tính phí khi chúng được ủy quyền.
• Sử dụng điểm cuối này để tiếp tục lại một địa chỉ đã dừng trước đó (nó phải ở trạng thái không hoạt động).