GET /apiv2/userinfo

उपयोगकर्ता जानकारी प्राप्त करें, जिसमें बैलेंस और उपयोग के आंकड़े शामिल हैं।

एंडपॉइंट URL

GET https://netts.io/apiv2/userinfo

अनुरोध हेडर

हेडर	आवश्यक	विवरण
X-API-KEY	हाँ	आपकी API कुंजी
X-Real-IP	हाँ	श्वेतसूची (व्हाइटलिस्ट) से IP पता

अनुरोध पैरामीटर

किसी पैरामीटर की आवश्यकता नहीं है - उपयोगकर्ता की जानकारी API कुंजी से निर्धारित होती है।

उदाहरण अनुरोध

cURL

curl -X GET https://netts.io/apiv2/userinfo \
  -H "X-API-KEY: your_api_key" \
  -H "X-Real-IP: your_whitelisted_ip"

Python

import requests

url = "https://netts.io/apiv2/userinfo"
headers = {
    "X-API-KEY": "your_api_key",
    "X-Real-IP": "your_whitelisted_ip"
}

response = requests.get(url, headers=headers)
data = response.json()

if response.status_code == 200:
    print(f"Status: {data.get('status')}")
    print(f"User ID: {data.get('user_id')}")
    
    user_info = data.get('user_info', {})
    print(f"Email: {user_info.get('email')}")
    print(f"Name: {user_info.get('name')}")
    print(f"Deposit Address: {user_info.get('deposit_address')}")
    
    stats = data.get('stats', {})
    print(f"Balance: {stats.get('balance')} TRX")
    print(f"Total Delegations: {stats.get('total_delegations')}")
    print(f"Total Energy Delegated: {stats.get('total_energy_delegated')}")
    print(f"Total TRX Spent: {stats.get('total_trx_spent')} TRX")
    print(f"Average Rate: {stats.get('avg_rate_sun_energy')} Sun/Energy")
    print(f"Savings: {stats.get('save_by_netts_percent')}%")
    print(f"Savings in USD: ${stats.get('save_in_dollars')}")
    
    network_info = data.get('network_info', {})
    print(f"TRX Price: ${network_info.get('trx_price')}")
    print(f"Network Energy Fee: {network_info.get('network_energy_fee')}")
else:
    print(f"Error: {data.get('message', 'Unknown error')}")

प्रतिक्रिया

सफल प्रतिक्रिया (200 OK)

{
    "status": "success",
    "timestamp": "2025-09-02 05:56:11",
    "user_id": 6,
    "user_info": {
        "email": "[email protected]",
        "name": "User Name",
        "deposit_address": "TDepositAddress1234567890123456789"
    },
    "stats": {
        "balance": 28361.15,
        "total_delegations": 96756,
        "total_energy_delegated": 21687058023,
        "total_trx_spent": 832181.95,
        "total_deposit": 0,
        "avg_rate_sun_energy": 38.37,
        "save_by_netts_percent": 61.63,
        "save_in_dollars": 453267.36
    },
    "network_info": {
        "trx_price": 0.3391,
        "network_energy_fee": 100.0
    }
}

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

फ़ील्ड	प्रकार	विवरण
status	string	सफल अनुरोधों के लिए हमेशा "success"
timestamp	string	YYYY-MM-DD HH:MM:SS प्रारूप में सर्वर टाइमस्टैम्प
user_id	integer	आंतरिक उपयोगकर्ता ID
user_info.email	string	उपयोगकर्ता ईमेल पता
user_info.name	string	उपयोगकर्ता का प्रदर्शित नाम
user_info.deposit_address	string	जमा (डिपॉजिट) के लिए TRON पता
stats.balance	number	कुल बैलेंस TRX - इसमें डिपॉजिट वॉलेट बैलेंस + लंबित पेआउट (Robot और सब-यूजर्स) - लंबित निकासी शामिल हैं
stats.total_delegations	integer	Energy डेलिगेशन की कुल संख्या
stats.total_energy_delegated	integer	डेलिगेट की गई कुल Energy इकाइयाँ
stats.total_trx_spent	number	Energy पर खर्च किए गए कुल TRX
stats.total_deposit	number	किए गए कुल डिपॉजिट
stats.avg_rate_sun_energy	number	प्रति Energy इकाई Sun में औसत दर
stats.save_by_netts_percent	number	TRX बर्न करने की तुलना में Netts का उपयोग करके प्रतिशत बचत
stats.save_in_dollars	number	डॉलर में बचत का मूल्य
network_info.trx_price	number	USD में वर्तमान TRX मूल्य
network_info.network_energy_fee	number	वर्तमान नेटवर्क Energy शुल्क

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

प्रमाणीकरण त्रुटि (401)

{
    "status": "error",
    "code": 401,
    "message": "Invalid API key or IP not in whitelist"
}

आंतरिक सर्वर त्रुटि (500)

{
    "status": "error", 
    "message": "Internal server error"
}

दर सीमाएं (रेट लिमिट्स)

इस एंडपॉइंट पर निम्नलिखित दर सीमाएं लागू होती हैं (प्रति IP पता):

अवधि	सीमा	विवरण
1 मिनट	6 अनुरोध	प्रति मिनट अधिकतम 6 अनुरोध

दर सीमा हेडर

API प्रतिक्रिया हेडर में दर सीमित करने की जानकारी लौटाता है:

RateLimit-Limit: 6
RateLimit-Remaining: 5
RateLimit-Reset: 45
X-RateLimit-Limit-Minute: 6
X-RateLimit-Remaining-Minute: 5
Retry-After: 45

दर सीमा पार हो गई (429)

{
    "message": "API rate limit exceeded",
    "request_id": "70257e0476dc396a11875532a45ce037"
}

जब दर सीमा पार हो जाए, तो अगला अनुरोध करने से पहले Retry-After हेडर में निर्दिष्ट समय तक प्रतीक्षा करें।

बैलेंस गणना विवरण

कुल बैलेंस TRX में शामिल हैं:

stats.balance फ़ील्ड कुल बैलेंस TRX लौटाता है जिसकी गणना इस प्रकार की जाती है:

Total Balance TRX = Deposit Wallet Balance + Pending Payouts - Pending Withdrawals

घटक:

• Deposit Wallet Balance: उपयोगकर्ता के डिपॉजिट पते में TRX बैलेंस
• Pending Payouts: Robot और सब-यूजर्स से TRX कमाई जो जमा होने की प्रतीक्षा में है
• Pending Withdrawals: लंबित निकासी अनुरोधों में TRX राशि

महत्वपूर्ण नोट्स:

महत्वपूर्ण

• Robot और सब-यूजर्स पेआउट TRX डिपॉजिट पते में प्रतिदिन 2 बार क्रेडिट किए जाते हैं
• क्रेडिट होने से पहले, Robot और सब-यूजर्स पेआउट TRX का उपयोग नहीं किया जा सकता Energy खरीद के लिए
• Robot और सब-यूजर्स पेआउट TRX/USDT निकालने के लिए, वेबसाइट पर निकासी फॉर्म में चेकबॉक्स को सक्रिय करें

नोट्स

• किसी अनुरोध बॉडी की आवश्यकता नहीं है - यह एक GET अनुरोध है
• उपयोगकर्ता की जानकारी प्रदान की गई API कुंजी से निर्धारित होती है
• सभी TRX मान दशमलव प्रारूप में हैं
• Energy मान मानक TRON Energy इकाइयों में हैं
• टाइमस्टैम्प सर्वर समय (UTC) में है
• दर सीमित करना (रेट लिमिटिंग): एकाधिक समय सीमाओं के साथ प्रति IP पता लागू किया गया
• त्रुटि कोड 429: दर सीमा पार होने पर लौटाया जाता है