GET /apiv2/userinfo

صارف کی معلومات حاصل کریں، بشمول بیلنس اور استعمال کے اعدادوشمار۔

اینڈپوائنٹ URL

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

درخواست کے ہیڈرز (Request Headers)

ہیڈر	لازمی	تفصیل
X-API-KEY	ہاں	آپ کی API کی
X-Real-IP	ہاں	وائٹ لسٹ سے IP ایڈریس

درخواست کے پیرامیٹرز (Request Parameters)

کوئی پیرامیٹرز درکار نہیں ہیں - صارف کی معلومات API کی سے معلوم کی جاتی ہیں۔

امثلہ برائے درخواست (Example Requests)

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')}")

جواب (Response)

کامیاب جواب (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
    }
}

جواب کے فیلڈز (Response Fields)

فیلڈ	قسم	تفصیل
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 اور Sub-users) - زیر التواء نکلوانے کی رقوم
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	اوسط شرح Sun فی Energy یونٹ میں
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 فیس

خرابی کے جوابات (Error Responses)

توثیق کی خرابی (401)

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

سرور کی اندرونی خرابی (500)

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

ریٹ کی حدود (Rate Limits)

اس اینڈپوائنٹ پر درج ذیل ریٹ کی حدود لاگو ہوتی ہیں (فی 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 اور Sub-users سے حاصل شدہ TRX کی کمائی جو کریڈٹ ہونے کی منتظر ہے
• Pending Withdrawals: زیر التواء نکالنے کی درخواستوں میں موجود TRX کی رقوم

اہم نوٹس:

اہم

• Robot اور Sub-users کی ادائیگی کے TRX ڈیپازٹ ایڈریس میں دن میں 2 بار کریڈٹ کیے جاتے ہیں
• کریڈٹ ہونے سے پہلے، Robot اور Sub-users کی ادائیگی کے TRX کو Energy کی خریداری کے لیے استعمال نہیں کیا جا سکتا
• Robot اور Sub-users کی ادائیگی کے TRX/USDT نکلوانے کے لیے، ویب سائٹ پر رقم نکلوانے کے فارم میں چیک باکس کو فعال کریں

نوٹس

• کسی درخواست باڈی کی ضرورت نہیں ہے - یہ ایک GET درخواست ہے
• صارف کی معلومات فراہم کردہ API کی سے طے کی جاتی ہیں
• تمام TRX اقدار اعشاری فارمیٹ میں ہیں
• Energy کی اقدار معیاری TRON Energy یونٹس میں ہیں
• ٹائم اسٹیمپ سرور کے وقت (UTC) میں ہے
• ریٹ لمٹنگ: متعدد وقتی وقفوں کے ساتھ فی IP ایڈریس لاگو کی جاتی ہے
• ایرر کوڈ 429: ریٹ کی حدود سے تجاوز ہونے پر واپس کیا جاتا ہے