POST /apiv2/time/infinitystart

เปิดใช้งานโหมด infinity (ไม่จำกัด) สำหรับแอดเดรสที่อยู่ใน Host Mode อยู่แล้ว — Energy จะได้รับการมอบหมายอย่างต่อเนื่องรอบแล้วรอบเล่าจนกว่าคุณจะหยุดใช้งาน

URL ของ Endpoint

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

การยืนยันตัวตน

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

เนื้อหาคำขอ (Request Body)

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

พารามิเตอร์

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

พฤติกรรมการทำงาน

• แอดเดรสดังกล่าวจะต้องมีอยู่ใน Host Mode อยู่แล้ว และต้องอยู่ในสถานะ ไม่ใช้งาน (หยุดทำงานอยู่)
• ยอดคงเหลือของคุณต้องครอบคลุมอย่างน้อยหนึ่งรอบตามราคาปัจจุบัน (มีการตรวจสอบก่อนเปิดใช้งาน)
• Endpoint นี้จะเปิดใช้งานแอดเดรส สร้างคำสั่งซื้อแบบ infinity ที่เปิดอยู่ และ Host Mode จะทำการมอบหมาย Energy ต่อเนื่องไปทีละรอบเรื่อยๆ จนกว่าคุณจะเรียกใช้ /apiv2/time/stop

รอบต่างๆ จะถูกเรียกเก็บเงินเมื่อมีการมอบหมาย (หนึ่งรอบต่อการมอบหมายหนึ่งครั้ง) การมอบหมายครั้งแรกของการเปิดใช้งานมีค่าใช้จ่าย 4 TRX; ในแต่ละครั้งถัดไปจะมีค่าใช้จ่าย 2 หรือ 4 TRX ขึ้นอยู่กับ Energy ที่การโอนก่อนหน้าของคุณใช้งานจริง (≤ 65,000 → 2 TRX, มากกว่านั้น → 4 TRX) ข้อกำหนดยอดขั้นต่ำรายวัน 8 TRX (มีผลบังคับใช้ 2026-08-29) และการปิดการทำงานเมื่อไม่มีการใช้งาน 2 วัน จะมีผลบังคับใช้ในโหมด infinity ด้วยเช่นกัน — ดูที่ Host Mode → รอบและราคา

ใน Time Status แอดเดรสที่เป็น infinity จะรายงานค่า cycles_ordered และ cycles_remaining เป็น null — เนื่องจากไม่มีขีดจำกัดสำหรับการนับถอยหลัง ให้เข้าใจความหมายของ null ว่า "ไม่จำกัด" ไม่ใช่ "ไม่มีรอบคงเหลือ"

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

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

การตอบกลับ (Response)

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

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

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

การตอบกลับเมื่อเกิดข้อผิดพลาด

code	msg	สาเหตุ
-1	API key required in X-API-KEY header or request body	ไม่ได้ระบุ API key
-1	Invalid API key or IP not in whitelist	การยืนยันตัวตนล้มเหลว
-1	Invalid TRC-20 address format	รูปแบบแอดเดรสไม่ถูกต้อง
-1	Failed to activate host mode	ไม่สามารถเปิดใช้งาน Host Mode ได้ — โปรดลองอีกครั้ง
-1	Database error activating infinity mode	ข้อผิดพลาดชั่วคราวทางฝั่งเซิร์ฟเวอร์ — โปรดลองอีกครั้ง
-1	Internal server error	เกิดข้อผิดพลาดที่ไม่คาดคิด — โปรดลองอีกครั้งหรือติดต่อฝ่ายสนับสนุน
-2	Insufficient balance. Required: X TRX, Available: Y TRX	ยอดคงเหลือต่ำกว่าราคาหนึ่งรอบ
-4	Address not found. Please add address first	ไม่พบแอดเดรสใน Host Mode
-5	Host mode is already active for this address	แอดเดรสกำลังทำงานอยู่แล้ว
-6	There is already an open order for this address	มีคำสั่งซื้อที่เปิดอยู่แล้วสำหรับแอดเดรสนี้

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

รหัสสถานะ HTTP

ข้อผิดพลาดของ Endpoint จะถูกส่งกลับมาพร้อมกับ HTTP 200 และ code ที่เป็นค่าลบ — ให้ตรวจสอบที่ code ไม่ใช่สถานะ HTTP เนื้อหาของข้อผิดพลาดจะมี "data": null รวมอยู่ด้วยเสมอ

ข้อผิดพลาดบางอย่างจะถูกส่งกลับมาก่อนที่คำขอจะไปถึง Endpoint โดยจะใช้สถานะที่ไม่ใช่ 200 และมีรูปแบบเนื้อหาที่แตกต่างออกไป:

HTTP	เนื้อหา (Body)	สาเหตุ
402	{"detail": {"code": 1004, "msg": "Insufficient funds. Minimum balance is 4 TRX. Please top up your account."}}	ยอดคงเหลือในบัญชีต่ำเกินไป
403	{"detail": {"code": 1005, "msg": "API key is blocked. Contact support."}}	API key ถูกระงับ — โปรดติดต่อฝ่ายสนับสนุน
422	{"detail": [ … ]}	เนื้อหาคำขอล้มเหลวในการตรวจสอบความถูกต้อง: ฟิลด์ที่จำเป็นขาดหายไปหรือมีชนิดข้อมูลที่ไม่ถูกต้อง โปรดทราบว่าจะไม่มีฟิลด์ code ในการตอบกลับนี้

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

• POST /apiv2/time/add — เพิ่มแอดเดรสก่อน
• POST /apiv2/time/order — ซื้อแบบกำหนดจำนวนรอบที่แน่นอนแทน
• POST /apiv2/time/stop — หยุดโหมด infinity
• POST /apiv2/time/status — ตรวจสอบสถานะ

หมายเหตุ

• โหมด infinity จะทำงานอย่างต่อเนื่องจนกว่าคุณจะหยุดด้วย /apiv2/time/stop
• โปรดรักษายอดคงเหลือให้เพียงพออยู่เสมอ — รอบต่างๆ จะถูกเรียกเก็บเงินเมื่อมีการมอบหมาย
• ใช้ Endpoint นี้เพื่อกลับมาเปิดใช้งานแอดเดรสที่เคยหยุดไปก่อนหน้านี้อีกครั้ง (แอดเดรสจะต้องอยู่ในสถานะไม่ใช้งาน)