POST /apiv2/time/order

Mua một số lượng chu kỳ ủy quyền năng lượng cụ thể cho một địa chỉ và kích hoạt Host Mode cho địa chỉ đó.

URL của Endpoint

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

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 được cấu hình cho API key của bạn.

Body của yêu cầu

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

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}$.
cycles	integer	Có	Số lượng chu kỳ cần mua. Phải ≥ 1.

Giá cả và thanh toán

• Việc đặt hàng các chu kỳ không tính phí trước. Mỗi chu kỳ sẽ được thanh toán tại thời điểm năng lượng của nó được ủy quyền: lần ủy quyền đầu tiên của một lần 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 mức năng lượng mà giao dịch chuyển trước đó của bạn thực sự tiêu thụ (≤65.000 → 2 TRX, nhiều hơn → 4 TRX). Xem Host Mode → Chu kỳ và Giá cả để biết các quy tắc đầy đủ, và Mức tối thiểu hàng ngày đối với mức tối thiểu 8 TRX hàng ngày (có hiệu lực từ ngày 29-08-2026).
• amount trong phản hồi là một ước tính (chu kỳ × giá tham chiếu), không phải tổng số tiền cuối cùng.
• Số dư của bạn sẽ được kiểm tra trước khi đơn hàng được chấp nhận; nếu số dư không đủ chi trả cho đơn hàng, đơn hàng sẽ bị từ chối (lỗi -2).

Việc đặt một đơn hàng sẽ đặt địa chỉ thành trạng thái active và tạo một đơn hàng mở cho số lượng chu kỳ đã yêu cầu. Sau đó, địa chỉ sẽ bắt đầu nhận các lần ủy quyền năng lượng theo từng chu kỳ và mỗi lần ủy quyền sẽ bị tính phí khi nó diễn ra.

Yêu cầu mẫu

cURL

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

Python

import requests

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

if result["code"] == 0:
    d = result["data"]
    print(f"Order {d['order_id']}: {d['cycles']} cycles for {d['amount']} TRX")
else:
    print("Error:", result["msg"])

Node.js

const axios = require('axios');

axios.post('https://netts.io/apiv2/time/order', {
    api_key: 'YOUR_API_KEY_HERE',
    address: 'TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE',
    cycles: 10,
}).then(({ data: result }) => {
    if (result.code === 0) {
        const d = result.data;
        console.log(`Order ${d.order_id}: ${d.cycles} cycles for ${d.amount} TRX`);
    } 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": "Cycles purchased and host mode activated successfully",
    "data": {
        "order_id": 5426,
        "address": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
        "cycles": 10,
        "amount": 23.5,
        "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	Tin nhắn cho người dùng đọc
data.order_id	integer	Định danh đơn hàng nội bộ
data.address	string	Địa chỉ mà các chu kỳ được mua
data.cycles	integer	Số chu kỳ đã mua
data.amount	number	Tổng giá trị đơn hàng ước tính, tính bằng TRX (chỉ để tham khảo — thanh toán theo từng lần ủy quyền)
data.status	string	"active" sau khi đặt hàng thành công
data.timestamp	string	Dấu thời gian ISO của đơn hàng

Phản hồi lỗi

code	msg	Nguyên nhân
-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	Cycle count must be 1 or more	cycles < 1
-1	Database error processing order	Lỗi tạm thời phía máy chủ — thử lại
-2	Insufficient balance. Required: X TRX, Available: Y TRX	Số dư thấp hơn tổng giá trị đơn hàng
-6	Cannot buy cycles: There is an open order with … cycles for this address	Một đơn hàng mở đã tồn tại (bao gồm vô hạn)

{
    "code": -2,
    "msg": "Insufficient balance. Required: 23.5 TRX, Available: 10.0 TRX"
}

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

Địa chỉ sẽ được kiểm tra trước khi đơn hàng được chấp nhận. 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 mã HTTP 403 và không có gì được ghi lại — không có đơn hàng nào được tạo và địa chỉ không được thêm vào hoặc bật lên. Phần thân phản hồi sử dụng định dạng detail:

code	msg	Ý nghĩa
1006	Address is blocked. Contact support.	Địa chỉ bị chặn
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.	Ủy quyền tài nguyên cho địa chỉ này không khả dụng
1011	This address is frozen and cannot receive resource delegation.	Địa chỉ bị đóng băng

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

Endpoint liên quan

• POST /apiv2/time/add — thêm địa chỉ trước
• POST /apiv2/time/infinitystart — chu kỳ không giới hạn thay vì số lượng cố định
• POST /apiv2/time/status — kiểm tra các chu kỳ còn lại
• POST /apiv2/time/stop — dừng và đóng đơn hàng

Lưu ý

• Nếu địa chỉ chưa có trong Host Mode, việc đặt hàng cũng sẽ đăng ký và kích hoạt địa chỉ đó.
• Chỉ cho phép một đơn hàng mở duy nhất cho mỗi địa chỉ tại một thời điểm.
• Các chu kỳ đã mua sẽ được tiêu thụ một chu kỳ cho mỗi lần ủy quyền; khi hết chu kỳ, địa chỉ sẽ tự động dừng lại.