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ố	Số dư Khả dụng TRX - số tiền dùng để thanh toán các đơn hàng energy; các khoản rút tiền đang chờ xử lý đã được trừ, các khoản thanh toán từ Robot & Người dùng phụ chưa được tính cho đến khi được cộng vào
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ố	Không được điền: luôn là 0. Lịch sử nạp tiền được hiển thị trong lịch sử ví trên trang quản lý
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ư

stats.balance Bao gồm Những gì:

Trường stats.balance trả về số dư khả dụng của tài khoản bằng TRX. Các đơn hàng energy được kiểm tra theo số tiền này và được thanh toán từ số tiền này.

• Các khoản Rút tiền Đang chờ xử lý: đã được trừ - yêu cầu rút tiền làm giảm số dư ngay khi được tạo
• Các khoản Thanh toán từ Robot & Người dùng phụ: chưa được tính cho đến khi được cộng vào số dư

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 độ