POST /apiv2/time/infinitystart

Host Mode में पहले से मौजूद किसी पते के लिए इनफिनिटी (असीमित) मोड सक्षम करें — जब तक आप इसे रोक नहीं देते, तब तक चक्र-दर-चक्र Energy डेलिगेट होती रहती है।

Endpoint URL

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

प्रमाणीकरण

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

अनुरोध Body

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

पैरामीटर्स

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}$। पता पहले से Host Mode में होना चाहिए (इसे पहले जोड़ें)।

व्यवहार

• पता पहले से ही Host Mode में मौजूद होना चाहिए और निष्क्रिय (रोका हुआ) होना चाहिए।
• आपका बैलेंस मौजूदा कीमत पर कम से कम एक चक्र को कवर करने लायक होना चाहिए (सक्रियण से पहले जाँचा जाता है)।
• यह एंडपॉइंट पते को सक्रिय करता है, एक खुला इनफिनिटी ऑर्डर बनाता है, और जब तक आप /apiv2/time/stop को कॉल नहीं करते, तब तक Host Mode चक्र-दर-चक्र Energy डेलिगेट करता रहता है।

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

Time Status में एक इनफिनिटी पता 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));

प्रतिक्रिया

सफलता (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"
    }
}

रिस्पॉन्स फ़ील्ड्स

Field	Type	Description
code	integer	0 = सफलता, ऋणात्मक = त्रुटि
msg	string	मानव-पठनीय संदेश
data.address	string	इनफिनिटी मोड में सक्रिय किया गया पता
data.order_id	integer	आंतरिक ऑर्डर पहचानकर्ता
data.mode	string	"infinity"
data.status	string	"active"
data.timestamp	string	ISO टाइमस्टैम्प

त्रुटि प्रतिक्रियाएं

code	msg	Cause
-1	API key required in X-API-KEY header or request body	कोई API कुंजी प्रदान नहीं की गई
-1	Invalid API key or IP not in whitelist	प्रमाणीकरण विफल रहा
-1	Invalid TRC-20 address format	अमान्य पता प्रारूप
-1	Failed to activate 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 स्थिति कोड

एंडपॉइंट त्रुटियाँ HTTP 200 और एक ऋणात्मक code के साथ लौटाई जाती हैं — HTTP स्थिति नहीं, बल्कि code की जाँच करें। त्रुटि बॉडी में हमेशा "data": null शामिल होता है।

कुछ त्रुटियाँ अनुरोध के एंडपॉइंट तक पहुँचने से पहले लौटाई जाती हैं। वे गैर-200 स्थिति और एक अलग बॉडी संरचना का उपयोग करती हैं:

HTTP	Body	Cause
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 कुंजी अवरुद्ध (ब्लॉक) है — सहायता से संपर्क करें
422	{"detail": [ … ]}	अनुरोध बॉडी सत्यापन विफल रहा: एक आवश्यक फ़ील्ड गायब है या गलत प्रकार की है। ध्यान दें कि इस रिस्पॉन्स में कोई code फ़ील्ड नहीं है

गंतव्य पता अनुमत नहीं है (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." } }

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

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

नोट्स

• इनफिनिटी मोड तब तक चलता है जब तक आप इसे /apiv2/time/stop के साथ रोक नहीं देते।
• पर्याप्त बैलेंस उपलब्ध रखें — चक्रों के डेलिगेट होते ही उनका शुल्क लिया जाता है।
• पहले से रोके गए किसी पते को फिर से शुरू करने के लिए इस एंडपॉइंट का उपयोग करें (यह निष्क्रिय होना चाहिए)।