POST /apiv2/time/infinitystart

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

URL của Endpoint

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 của yêu cầu phải nằm trong danh sách trắng (whitelist) được định cấu hình cho API key của bạn.

Body của yêu cầu

json

{
    "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ỉ này phải đã có trong Host Mode (thêm nó vào 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ả cho í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 vô hạn mở, và Host Mode tiếp tục ủy quyền Energy hết chu kỳ này đến chu kỳ khác cho đến khi bạn gọi /apiv2/time/stop.

Các chu kỳ được tính phí ngay 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 lượ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 khoản trước đó của bạn thực sự đã 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ừ 2026-08-29) và việc tắt máy khi không hoạt động sau 2 ngày cũng áp dụng trong chế độ vô hạn — xem Host Mode → Các chu kỳ và giá cả và Mức tối thiểu hàng ngày.

Trong Time Status, một địa chỉ vô hạn 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ỳ”.

Yêu cầu mẫu

cURL

bash

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

Python

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

javascript

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)

json

{
    "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 dễ đọc cho người dùng
data.address	string	Địa chỉ được kích hoạt trong chế độ vô hạn
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ệ 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ỉ hiện đã đang chạy
-6	`There is already an open order for this address`	Một đơn hàng mở đã tồn tại

json

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

Mã trạng thái HTTP

Các lỗi đ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à định dạng phần thân khác:

HTTP	Phần 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ệ hỗ trợ
422	`{"detail": [ … ]}`	Phần thân yêu cầu không vượt qua được xác thực: thiếu trường bắt buộc hoặc sai kiểu dữ liệu. Lưu ý không có trường `code` trong phản hồi này

Địa chỉ đích không được phép (403)

Địa chỉ được kiểm tra trước khi nó được bật. Nếu việc ủy quyền tài nguyên cho địa chỉ đó không được phép, yêu cầu sẽ bị từ chối với HTTP 403 và không có dữ liệu nào được ghi — địa chỉ vẫn không hoạt động và không có đơn hàng nào được tạo. Phần thân sử dụng định dạng detail:

code	msg	Ý nghĩa
1006	`Address is blocked. Contact support.`	Địa chỉ đã bị khóa
1007	`Energy rental to smart contracts is not supported.`	Địa chỉ là một hợp đồng thông minh (địa chỉ ví GasFree cũng là hợp đồng thông minh)
1010	`Resource delegation to this address is not available.`	Không thể ủy quyền tài nguyên cho địa chỉ này
1011	`This address is frozen and cannot receive resource delegation.`	Địa chỉ bị đóng băng và không thể nhận ủy quyền tài nguyên

json

{ "detail": { "code": 1007, "msg": "Energy rental to smart contracts is not supported." } }

Các điểm cuối liên quan

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

Ghi chú

Chế độ vô hạn 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í ngay khi chúng được ủy quyền.
Sử dụng điểm cuối này để tiếp tục chạy một địa chỉ đã dừng trước đó (địa chỉ phải đang ở trạng thái không hoạt động).

POST /apiv2/time/infinitystart ​

URL của Endpoint ​

Xác thực ​

Body của yêu cầu ​

Tham số ​

Hành vi ​

Yêu cầu mẫu ​

cURL ​

Python ​

Node.js ​

Phản hồi ​

Thành công (200 OK) ​

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

Phản hồi lỗi ​

Mã trạng thái HTTP ​

Địa chỉ đích không được phép (403) ​

Các điểm cuối liên quan ​

Ghi chú ​

POST /apiv2/time/infinitystart

URL của Endpoint

Xác thực

Body của yêu cầu

Tham số

Hành vi

Yêu cầu mẫu

cURL

Python

Node.js

Phản hồi

Thành công (200 OK)

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

Phản hồi lỗi

Mã trạng thái HTTP

Địa chỉ đích không được phép (403)

Các điểm cuối liên quan

Ghi chú