GET /apiv2/userinfo

Mengambil informasi pengguna, termasuk saldo dan statistik penggunaan.

URL Endpoint

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

Header Permintaan

Header	Wajib	Deskripsi
X-API-KEY	Ya	Kunci API Anda
X-Real-IP	Ya	Alamat IP dari daftar putih

Parameter Permintaan

Tidak ada parameter yang diperlukan - informasi pengguna ditentukan dari kunci API.

Contoh Permintaan

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

Respons

Respons Sukses (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
    }
}

Bidang Respons

Bidang	Tipe	Deskripsi
status	string	Selalu "success" untuk permintaan yang berhasil
timestamp	string	Stempel waktu server dalam format YYYY-MM-DD HH:MM:SS
user_id	integer	ID pengguna internal
user_info.email	string	Alamat email pengguna
user_info.name	string	Nama tampilan pengguna
user_info.deposit_address	string	Alamat TRON untuk deposit
stats.balance	number	Total Saldo TRX - mencakup saldo dompet deposit + pembayaran tertunda (Robot & Sub-users) - penarikan tertunda
stats.total_delegations	integer	Jumlah total delegasi energi
stats.total_energy_delegated	integer	Total unit energi yang didelegasikan
stats.total_trx_spent	number	Total TRX yang dihabiskan untuk energi
stats.total_deposit	number	Total deposit yang dilakukan
stats.avg_rate_sun_energy	number	Tarif rata-rata dalam Sun per unit energi
stats.save_by_netts_percent	number	Persentase penghematan menggunakan NETTS dibandingkan dengan membakar TRX
stats.save_in_dollars	number	Nilai penghematan dalam dolar
network_info.trx_price	number	Harga TRX saat ini dalam USD
network_info.network_energy_fee	number	Biaya energi jaringan saat ini

Respons Kesalahan

Kesalahan Autentikasi (401)

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

Kesalahan Server Internal (500)

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

Batas Laju

Batas laju berikut berlaku untuk endpoint ini (per alamat IP):

Periode	Batas	Deskripsi
1 menit	6 permintaan	Maksimum 6 permintaan per menit

Header Batas Laju

API mengembalikan informasi pembatasan laju di header respons:

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

Batas Laju Terlampaui (429)

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

Ketika batas laju terlampaui, tunggu hingga waktu yang ditentukan dalam header Retry-After sebelum membuat permintaan berikutnya.

Rincian Perhitungan Saldo

Total Saldo TRX Mencakup:

Bidang stats.balance mengembalikan Total Saldo TRX yang dihitung sebagai:

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

Komponen:

• Saldo Dompet Deposit: Saldo TRX di alamat deposit pengguna
• Pembayaran Tertunda: Pendapatan TRX dari Robot dan Sub-users yang menunggu untuk dikreditkan
• Penarikan Tertunda: Jumlah TRX dalam permintaan penarikan yang tertunda

Catatan Penting:

Penting

• TRX pembayaran Robot & Sub-users dikreditkan ke alamat deposit 2 kali per hari
• Sebelum dikreditkan, TRX pembayaran Robot & Sub-users tidak dapat digunakan untuk pembelian energi
• Untuk menarik TRX/USDT pembayaran Robot & Sub-users, aktifkan kotak centang pada formulir penarikan di situs web

Catatan

• Tidak ada badan permintaan yang diperlukan - ini adalah permintaan GET
• Informasi pengguna ditentukan dari kunci API yang diberikan
• Semua nilai TRX dalam format desimal
• Nilai energi dalam unit TRON Energy standar
• Stempel waktu dalam waktu server (UTC)
• Pembatasan laju: Diberlakukan per alamat IP dengan beberapa jendela waktu
• Kode kesalahan 429: Dikembalikan ketika batas laju terlampaui