GET /apiv2/userinfo

获取用户信息，包括余额和使用统计数据。

端点 URL

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

请求头

请求头	必填	描述
X-API-KEY	是	您的 API 密钥
X-Real-IP	是	来自白名单的 IP 地址

请求参数

无需参数 - 用户信息由 API 密钥确定。

请求示例

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

响应

成功响应 (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
    }
}

响应字段

字段	类型	描述
status	字符串	成功请求时始终为 "success"
timestamp	字符串	服务器时间戳，格式为 YYYY-MM-DD HH:MM:SS
user_id	整数	内部用户 ID
user_info.email	字符串	用户电子邮箱地址
user_info.name	字符串	用户显示名称
user_info.deposit_address	字符串	用于充值的 TRON 地址
stats.balance	数字	总 TRX 余额 - 包括充值钱包余额 + 待入账收益（机器人与子用户）- 待处理提现
stats.total_delegations	整数	Energy 质押代理总次数
stats.total_energy_delegated	整数	已质押代理的 Energy 总量单位
stats.total_trx_spent	数字	用于 Energy 的 TRX 总支出
stats.total_deposit	数字	累计充值总额
stats.avg_rate_sun_energy	数字	平均单价（每单位 Energy 所需 Sun）
stats.save_by_netts_percent	数字	相比直接燃烧 TRX，使用 Netts 节省的百分比
stats.save_in_dollars	数字	折合美元的节省金额
network_info.trx_price	数字	当前 TRX 美元价格
network_info.network_energy_fee	数字	当前网络 Energy 费用

错误响应

身份验证错误 (401)

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

服务器内部错误 (500)

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

速率限制

以下速率限制适用于此端点（按 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 余额，其计算方式为：

总 TRX 余额 = 充值钱包余额 + 待入账收益 - 待处理提现

组成部分：

• 充值钱包余额：用户充值地址中的 TRX 余额
• 待入账收益：来自机器人和子用户、等待入账的 TRX 收益
• 待处理提现：处于待处理提现申请中的 TRX 金额

重要提示：

重要提示

• 机器人和子用户结算的 TRX 每日 2 次入账至充值地址
• 在入账之前，机器人和子用户结算的 TRX 不可用于购买 Energy
• 如需提现机器人和子用户结算的 TRX/USDT，请在网站提现表单中勾选对应复选框

注意事项

• 无需请求体 - 此为 GET 请求
• 用户信息根据提供的 API 密钥确定
• 所有 TRX 数值均采用小数格式
• Energy 数值采用标准 TRON Energy 单位
• 时间戳为服务器时间（UTC）
• 速率限制：按 IP 地址在多个时间窗口内强制执行
• 错误代码 429：在超出速率限制时返回