POST /apiv2/time/order

किसी पते के लिए Energy डेलिगेशन साइकिलों की एक निश्चित संख्या खरीदें और उसके लिए Host Mode सक्रिय करें।

एंडपॉइंट URL

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

प्रमाणीकरण

अनुरोध बॉडी (api_key) या X-API-KEY हेडर में अपनी API कुंजी प्रदान करें। अनुरोध IP आपकी API कुंजी के लिए कॉन्फ़िगर की गई श्वेतसूची (whitelist) में होना चाहिए।

अनुरोध बॉडी

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

पैरामीटर्स

Parameter	Type	Required	Description
api_key	string	Yes	API कुंजी (या X-API-KEY हेडर)।
address	string	Yes	TRON (TRC-20) पता, ^T[1-9A-HJ-NP-Za-km-z]{33}$।
cycles	integer	Yes	खरीदे जाने वाले साइकिलों की संख्या। ≥ 1 होना चाहिए।

मूल्य निर्धारण और बिलिंग

• साइकिल ऑर्डर करने पर आपसे अग्रिम शुल्क नहीं लिया जाता है। प्रत्येक साइकिल का बिल उसी समय भेजा जाता है जब उसकी Energy डेलिगेट की जाती है: एक एक्टिवेशन के पहले डेलिगेशन की लागत 4 TRX होती है, उसके बाद के प्रत्येक डेलिगेशन की लागत आपके पिछले ट्रांसफर द्वारा वास्तव में उपभोग की गई Energy के आधार पर 2 या 4 TRX होती है (≤65,000 → 2 TRX, अधिक → 4 TRX)। 8 TRX दैनिक न्यूनतम (2026-08-29 से प्रभावी) सहित पूर्ण नियमों के लिए Host Mode → Cycles and Pricing देखें।
• प्रतिक्रिया में दिया गया amount एक अनुमान है (cycles × reference price), अंतिम कुल नहीं।
• ऑर्डर स्वीकार करने से पहले आपके बैलेंस की जांच की जाती है; यदि यह ऑर्डर को कवर नहीं कर सकता है, तो ऑर्डर अस्वीकार कर दिया जाता है (त्रुटि -2)।

ऑर्डर देने से पता सक्रिय पर सेट हो जाता है और अनुरोधित साइकिलों की संख्या के लिए एक खुला ऑर्डर बन जाता है। इसके बाद पते पर चक्र-दर-चक्र 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"
    }
}

प्रतिक्रिया फ़ील्ड

Field	Type	Description
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	Cause
-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"
}

संबंधित एंडपॉइंट्स

• POST /apiv2/time/add — पहले पता जोड़ें
• POST /apiv2/time/infinitystart — एक निश्चित संख्या के बजाय असीमित साइकिल
• POST /apiv2/time/status — शेष साइकिलों की जांच करें
• POST /apiv2/time/stop — रोकें और ऑर्डर बंद करें

नोट्स

• यदि पता अभी तक Host Mode में नहीं है, तो ऑर्डर करने से यह पंजीकृत भी हो जाता है और सक्रिय भी हो जाता है।
• प्रति पते पर एक समय में केवल एक ही खुले ऑर्डर की अनुमति है।
• खरीदे गए साइकिल प्रति डेलिगेशन एक के हिसाब से उपभोग किए जाते हैं; जब वे समाप्त हो जाते हैं तो पता स्वचालित रूप से बंद हो जाता है।