POST /apiv2/time/order

ซื้อรอบการมอบสิทธิ์ Energy ตามจำนวนที่กำหนดสำหรับที่อยู่ และเปิดใช้งาน Host Mode สำหรับที่อยู่นั้น

URL ของ Endpoint

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

การตรวจสอบสิทธิ์

ระบุ API key ของคุณในเนื้อหาคำขอ (api_key) หรือในส่วนหัว X-API-KEY โดย IP ของคำขอต้องอยู่ในไวท์ลิสต์ที่กำหนดค่าไว้สำหรับ API key ของคุณ

เนื้อหาคำขอ

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

พารามิเตอร์

พารามิเตอร์	ชนิด	จำเป็น	คำอธิบาย
api_key	string	ใช่	API key (หรือส่วนหัว X-API-KEY)
address	string	ใช่	ที่อยู่ TRON (TRC-20), ^T[1-9A-HJ-NP-Za-km-z]{33}$
cycles	integer	ใช่	จำนวนรอบที่ต้องการซื้อ ต้องเป็น ≥ 1

ราคาและการเรียกเก็บเงิน

• การสั่งซื้อรอบจะไม่มีการเรียกเก็บเงินล่วงหน้า แต่ละรอบจะถูกเรียกเก็บเงินในขณะที่มีการมอบสิทธิ์ Energy: การมอบสิทธิ์ครั้งแรกของการเปิดใช้งานมีค่าใช้จ่าย 4 TRX ส่วนครั้งถัดไปแต่ละครั้งมีค่าใช้จ่าย 2 หรือ 4 TRX ขึ้นอยู่กับ Energy ที่การโอนก่อนหน้าของคุณใช้งานจริง (≤65,000 → 2 TRX, มากกว่านั้น → 4 TRX) ดู Host Mode → Cycles and Pricing สำหรับกฎเกณฑ์ฉบับเต็ม รวมถึงยอดขั้นต่ำรายวัน 8 TRX (มีผลบังคับใช้ 2026-08-29)
• ค่า amount ในการตอบกลับคือ ค่าประมาณการ (cycles × reference price) ไม่ใช่ยอดรวมขั้นสุดท้าย
• ยอดคงเหลือของคุณจะได้รับการตรวจสอบก่อนที่คำสั่งซื้อจะได้รับการยอมรับ หากยอดเงินไม่เพียงพอสำหรับคำสั่งซื้อ คำสั่งซื้อจะถูกปฏิเสธ (ข้อผิดพลาด -2)

การสร้างคำสั่งซื้อจะตั้งค่าที่อยู่ให้เป็น active และสร้างคำสั่งซื้อที่เปิดอยู่สำหรับจำนวนรอบที่ร้องขอ จากนั้นที่อยู่จะเริ่มได้รับการมอบสิทธิ์ Energy ไปทีละรอบ และจะมีการเรียกเก็บเงินสำหรับการมอบสิทธิ์แต่ละครั้งเมื่อเกิดขึ้น

ตัวอย่างคำขอ

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));

การตอบกลับ

สำเร็จ (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"
    }
}

ฟิลด์ในการตอบกลับ

ฟิลด์	ชนิด	คำอธิบาย
code	integer	0 = สำเร็จ, ค่าลบ = ข้อผิดพลาด
msg	string	ข้อความที่มนุษย์อ่านได้
data.order_id	integer	ตัวระบุคำสั่งซื้อภายใน
data.address	string	ที่อยู่ที่ทำการซื้อรอบให้
data.cycles	integer	จำนวนรอบที่ซื้อ
data.amount	number	ยอดรวมคำสั่งซื้อโดยประมาณ ในหน่วย TRX (สำหรับการอ้างอิงเท่านั้น — การเรียกเก็บเงินจะคิดต่อการมอบสิทธิ์)
data.status	string	"active" หลังจากสร้างคำสั่งซื้อสำเร็จ
data.timestamp	string	การประทับเวลา ISO ของคำสั่งซื้อ

การตอบกลับข้อผิดพลาด

code	msg	สาเหตุ
-1	Invalid API key or IP not in whitelist	การยืนยันตัวตนล้มเหลว
-1	Invalid TRC-20 address format	รูปแบบที่อยู่ไม่ถูกต้อง
-1	Cycle count must be 1 or more	cycles < 1
-1	Database error processing order	ข้อผิดพลาดชั่วคราวที่ฝั่งเซิร์ฟเวอร์ — ให้ลองใหม่อีกครั้ง
-2	Insufficient balance. Required: X TRX, Available: Y TRX	ยอดเงินคงเหลือต่ำกว่ายอดรวมคำสั่งซื้อ
-6	Cannot buy cycles: There is an open order with … cycles for this address	มีคำสั่งซื้อที่เปิดอยู่แล้วสำหรับที่อยู่นี้ (รวมถึงแบบไม่จำกัด)

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

Endpoint ที่เกี่ยวข้อง

• POST /apiv2/time/add — เพิ่มที่อยู่ก่อน
• POST /apiv2/time/infinitystart — ใช้งานรอบแบบไม่จำกัดแทนจำนวนคงที่
• POST /apiv2/time/status — ตรวจสอบรอบที่เหลืออยู่
• POST /apiv2/time/stop — หยุดและปิดคำสั่งซื้อ

หมายเหตุ

• หากที่อยู่ยังไม่ได้อยู่ใน Host Mode การสั่งซื้อจะเป็นการลงทะเบียนและเปิดใช้งานไปพร้อมกัน
• อนุญาตให้มีคำสั่งซื้อที่เปิดอยู่ได้เพียงหนึ่งคำสั่งซื้อต่อหนึ่งที่อยู่ ณ เวลาหนึ่งๆ
• รอบที่ซื้อจะถูกใช้งานไปทีละหนึ่งรอบต่อการมอบสิทธิ์หนึ่งครั้ง เมื่อรอบหมดลง ที่อยู่จะหยุดทำงานโดยอัตโนมัติ