POST /apiv2/time/order

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

URL Điểm cuối

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 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.

Phần thân 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ố chu kỳ cần mua. Phải ≥ 1.

Giá cả và thanh toán

• Việc đặt mua các chu kỳ không tính phí bạn trước. Mỗi chu kỳ được lập hóa đơn tại thời điểm Energy của nó được ủ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 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 đủ, bao gồm mức tối thiểu hàng ngày 8 TRX (có hiệu lực từ ngày 29-08-2026).
• amount trong phản hồi là một ước tính (cycles × reference price), không phải là tổng số tiền cuối cùng.
• Số dư của bạn được kiểm tra trước khi đơn hàng được chấp nhận; nếu không thể chi trả cho đơn hàng, đơn hàng sẽ bị từ chối (lỗi -2).

Việc đặt đơn hàng sẽ đặt địa chỉ thành active và tạo một đơn hàng đang mở cho số lượng chu kỳ được yêu cầu. Địa chỉ sau đó bắt đầu nhận các lần ủy quyền Energy 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	Thông báo dễ đọc cho người dùng
data.order_id	integer	Định danh đơn hàng nội bộ
data.address	string	Địa chỉ mà các chu kỳ đã được mua cho nó
data.cycles	integer	Số lượng chu kỳ đã mua
data.amount	number	Tổng chi phí đơn hàng ước tính, tính bằng TRX (chỉ mang tính tham khảo — việc lập hóa đơn diễn ra theo từng lần ủy quyền)
data.status	string	"active" sau khi đặt đơn 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 chi phí đơn hàng
-6	Cannot buy cycles: There is an open order with … cycles for this address	Một đơn hàng đang mở đã tồn tại (bao gồm cả vô hạn)

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

Các Điểm cuối 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 mua cũng sẽ đăng ký và kích hoạt nó.
• Chỉ cho phép một đơn hàng đang mở cho mỗi địa chỉ tại một thời điểm.
• Các chu kỳ đã mua sẽ được tiêu thụ từng chu kỳ một cho mỗi lần ủy quyền; khi hết chu kỳ, địa chỉ sẽ tự động dừng.