POST /apiv2/time/order

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

Endpoint URL

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

प्रमाणीकरण (Authentication)

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

अनुरोध Body

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

गंतव्य पता अनुमत नहीं है (403)

ऑर्डर स्वीकार किए जाने से पहले पते की जांच की जाती है। यदि इस पर संसाधन डेलिगेशन की अनुमति नहीं है, तो अनुरोध को HTTP 403 के साथ अस्वीकार कर दिया जाता है और कुछ भी नहीं लिखा जाता है — कोई ऑर्डर नहीं बनाया जाता है और पता नहीं जोड़ा जाता है या चालू नहीं किया जाता है। मुख्य भाग detail प्रारूप का उपयोग करता है:

code	msg	Meaning
1006	Address is blocked. Contact support.	पता ब्लॉक कर दिया गया है
1007	Energy rental to smart contracts is not supported.	पता एक स्मार्ट अनुबंध है (GasFree वॉलेट पते भी स्मार्ट अनुबंध होते हैं)
1010	Resource delegation to this address is not available.	इस पते पर संसाधन डेलिगेशन उपलब्ध नहीं है
1011	This address is frozen and cannot receive resource delegation.	पता फ्रीज कर दिया गया है और संसाधन डेलिगेशन प्राप्त नहीं कर सकता है

{ "detail": { "code": 1007, "msg": "Energy rental to smart contracts is not supported." } }

संबंधित Endpoints

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

नोट्स

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