GET /apiv2/userinfo

Bakiye ve kullanım istatistikleri dahil olmak üzere kullanıcı bilgilerini alın.

Uç Nokta URL'si

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

İstek Başlıkları

Başlık	Gerekli	Açıklama
X-API-KEY	Evet	API anahtarınız
X-Real-IP	Evet	Beyaz listedeki IP adresi

İstek Parametreleri

Herhangi bir parametre gerekmez - kullanıcı bilgileri API anahtarından belirlenir.

Örnek İstekler

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

Yanıt

Başarılı Yanıt (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
    }
}

Yanıt Alanları

Alan	Tür	Açıklama
status	string	Başarılı istekler için her zaman "success"
timestamp	string	YYYY-MM-DD HH:MM:SS formatında sunucu zaman damgası
user_id	integer	Dahili kullanıcı kimliği
user_info.email	string	Kullanıcı e-posta adresi
user_info.name	string	Kullanıcı görünen adı
user_info.deposit_address	string	Yatırma işlemleri için TRON adresi
stats.balance	number	Toplam Bakiye TRX - yatırma cüzdanı bakiyesi + bekleyen ödemeler (Robot ve Alt kullanıcılar) - bekleyen çekimleri içerir
stats.total_delegations	integer	Toplam enerji delege etme sayısı
stats.total_energy_delegated	integer	Delege edilen toplam enerji birimi
stats.total_trx_spent	number	Enerji için harcanan toplam TRX
stats.total_deposit	number	Yapılan toplam yatırma işlemleri
stats.avg_rate_sun_energy	number	Enerji birimi başına Sun cinsinden ortalama oran
stats.save_by_netts_percent	number	TRX yakmaya kıyasla Netts kullanılarak tasarruf edilen yüzde
stats.save_in_dollars	number	Tasarrufların dolar cinsinden değeri
network_info.trx_price	number	USD cinsinden mevcut TRX fiyatı
network_info.network_energy_fee	number	Mevcut ağ enerji ücreti

Hata Yanıtları

Kimlik Doğrulama Hatası (401)

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

Sunucu İçi Hata (500)

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

İstek Limitleri

Bu uç nokta için aşağıdaki istek limitleri geçerlidir (IP adresi başına):

Dönem	Limit	Açıklama
1 dakika	6 istek	Dakika başına maksimum 6 istek

İstek Limiti Başlıkları

API, istek sınırlama bilgilerini yanıt başlıklarında döndürür:

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

İstek Limiti Aşıldı (429)

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

İstek limiti aşıldığında, bir sonraki isteği yapmadan önce Retry-After başlığında belirtilen süre kadar bekleyin.

Bakiye Hesaplama Detayları

Toplam Bakiye TRX Şunları İçerir:

stats.balance alanı şu şekilde hesaplanan Toplam Bakiye TRX değerini döndürür:

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

Bileşenler:

• Yatırma Cüzdanı Bakiyesi: Kullanıcının yatırma adresindeki TRX bakiyesi
• Bekleyen Ödemeler: Robot ve Alt kullanıcılardan gelen, hesaba geçmeyi bekleyen TRX kazançları
• Bekleyen Çekimler: Bekleyen çekim taleplerindeki TRX tutarları

Önemli Notlar:

Önemli

• Robot ve Alt kullanıcı ödeme TRX'leri, yatırma adresine günde 2 kez aktarılır
• Aktarılmadan önce, Robot ve Alt kullanıcı ödeme TRX'leri enerji alımları için kullanılamaz
• Robot ve Alt kullanıcı ödemesi olan TRX/USDT'yi çekmek için web sitesindeki çekim formunda bulunan onay kutusunu etkinleştirin

Notlar

• İstek gövdesi gerekmez - bu bir GET isteğidir
• Kullanıcı bilgileri sağlanan API anahtarından belirlenir
• Tüm TRX değerleri ondalık formattadır
• Energy değerleri standart TRON enerji birimlerindedir
• Zaman damgası sunucu saatindedir (UTC)
• İstek sınırlaması: Birden fazla zaman penceresiyle IP adresi başına uygulanır
• Hata kodu 429: İstek limitleri aşıldığında döndürülür