GET /apiv2/userinfo

Lấy thông tin người dùng, bao gồm số dư và số liệu thống kê sử dụng.

URL Điểm cuối

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

Tiêu đề Yêu cầu

Tiêu đề	Bắt buộc	Mô tả
X-API-KEY	Có	Khóa API của bạn
X-Real-IP	Có	Địa chỉ IP từ danh sách trắng

Tham số Yêu cầu

Không yêu cầu tham số - thông tin người dùng được xác định từ khóa API.

Yêu cầu Mẫu

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

Phản hồi

Phản hồi Thành công (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
    }
}

Các Trường Phản hồi

Trường	Kiểu	Mô tả
status	chuỗi	Luôn là "success" đối với các yêu cầu thành công
timestamp	chuỗi	Dấu thời gian máy chủ theo định dạng YYYY-MM-DD HH:MM:SS
user_id	số nguyên	ID người dùng nội bộ
user_info.email	chuỗi	Địa chỉ email người dùng
user_info.name	chuỗi	Tên hiển thị của người dùng
user_info.deposit_address	chuỗi	Địa chỉ TRON để nạp tiền
stats.balance	số	Tổng Số dư TRX - bao gồm số dư ví nạp + các khoản thanh toán đang chờ xử lý (Robot & Người dùng phụ) - các khoản rút tiền đang chờ xử lý
stats.total_delegations	số nguyên	Tổng số lần ủy quyền energy
stats.total_energy_delegated	số nguyên	Tổng số đơn vị energy đã ủy quyền
stats.total_trx_spent	số	Tổng số TRX đã chi cho energy
stats.total_deposit	số	Tổng số tiền đã nạp
stats.avg_rate_sun_energy	số	Mức phí trung bình tính bằng Sun trên mỗi đơn vị energy
stats.save_by_netts_percent	số	Tỷ lệ phần trăm tiết kiệm được khi sử dụng Netts so với việc đốt TRX
stats.save_in_dollars	số	Giá trị tiết kiệm được quy đổi ra Đô la
network_info.trx_price	số	Giá TRX hiện tại bằng USD
network_info.network_energy_fee	số	Phí energy mạng hiện tại

Phản hồi Lỗi

Lỗi Xác thực (401)

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

Lỗi Máy chủ Nội bộ (500)

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

Giới hạn Tốc độ

Các giới hạn tốc độ sau áp dụng cho điểm cuối này (trên mỗi địa chỉ IP):

Khoảng thời gian	Giới hạn	Mô tả
1 phút	6 yêu cầu	Tối đa 6 yêu cầu mỗi phút

Tiêu đề Giới hạn Tốc độ

API trả về thông tin giới hạn tốc độ trong các tiêu đề phản hồi:

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

Vượt quá Giới hạn Tốc độ (429)

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

Khi vượt quá giới hạn tốc độ, hãy đợi khoảng thời gian được chỉ định trong tiêu đề Retry-After trước khi thực hiện yêu cầu tiếp theo.

Chi tiết Tính toán Số dư

Tổng Số dư TRX Bao gồm:

Trường stats.balance trả về Tổng Số dư TRX được tính như sau:

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

Các thành phần:

• Số dư Ví nạp: Số dư TRX trong địa chỉ nạp của người dùng
• Các khoản Thanh toán Đang chờ xử lý: Thu nhập TRX từ Robot và Người dùng phụ đang chờ được cộng vào tài khoản
• Các khoản Rút tiền Đang chờ xử lý: Số lượng TRX trong các yêu cầu rút tiền đang chờ xử lý

Lưu ý Quan trọng:

Quan trọng

• TRX thanh toán từ Robot & Người dùng phụ được cộng vào địa chỉ nạp 2 lần mỗi ngày
• Trước khi được cộng, TRX thanh toán từ Robot & Người dùng phụ không thể sử dụng để mua energy
• Để rút TRX/USDT thanh toán từ Robot & Người dùng phụ, hãy tích vào ô đánh dấu trong biểu mẫu rút tiền trên trang web

Lưu ý

• Không yêu cầu phần thân yêu cầu - đây là yêu cầu GET
• Thông tin người dùng được xác định từ khóa API được cung cấp
• Tất cả các giá trị TRX đều ở định dạng thập phân
• Các giá trị Energy đều ở đơn vị energy tiêu chuẩn của TRON
• Dấu thời gian theo giờ máy chủ (UTC)
• Giới hạn tốc độ: Được áp dụng trên mỗi địa chỉ IP với nhiều khung thời gian
• Mã lỗi 429: Được trả về khi vượt quá giới hạn tốc độ