POST /apiv2/time/order

ایک ایڈریس کے لیے Energy ڈیلیگیشن کے مخصوص چکر (cycles) خریدیں اور اس کے لیے Host Mode کو فعال کریں۔

اینڈپوائنٹ URL

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

تصدیق (Authentication)

درخواست کے باڈی (api_key) یا X-API-KEY ہیڈر میں اپنی API کلید فراہم کریں۔ درخواست کا IP اس وائٹ لسٹ میں ہونا چاہیے جو آپ کی API کلید کے لیے ترتیب دی گئی ہے۔

درخواست کی باڈی (Request Body)

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

پیرامیٹرز

پیرامیٹر	قسم	درکار ہے	تفصیل
api_key	string	ہاں	API کلید (یا 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)۔ مکمل قواعد بشمول روزانہ کی کم از کم 8 TRX کی حد (نافذ العمل 2026-08-29) کے لیے Host Mode → Cycles and Pricing دیکھیں۔
• رسپانس میں موجود 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	ایک کھلا آرڈر پہلے سے موجود ہے (بشمول infinity)

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

متعلقہ اینڈپوائنٹس

• POST /apiv2/time/add — پہلے ایڈریس شامل کریں
• POST /apiv2/time/infinitystart — مقررہ تعداد کے بجائے لامحدود چکر
• POST /apiv2/time/status — باقی چکر چیک کریں
• POST /apiv2/time/stop — روکیں اور آرڈر بند کریں

نوٹس

• اگر ایڈریس ابھی تک Host Mode میں نہیں ہے، تو آرڈر کرنے سے یہ رجسٹر بھی ہو جاتا ہے اور فعال بھی۔
• ایک وقت میں فی ایڈریس صرف ایک کھلا آرڈر رکھنے کی اجازت ہے۔
• خریدے گئے چکر فی ڈیلیگیشن ایک کے حساب سے استعمال ہوتے ہیں؛ جب وہ ختم ہو جاتے ہیں تو ایڈریس خود بخود رک جاتا ہے۔