GET /apiv2/userinfo

Recupera informações do usuário, incluindo saldo e estatísticas de uso.

URL do Endpoint

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

Cabeçalhos da Requisição

Cabeçalho	Obrigatório	Descrição
X-API-KEY	Sim	Sua chave de API
X-Real-IP	Sim	Endereço IP da lista de permissões

Parâmetros da Requisição

Nenhum parâmetro obrigatório - as informações do usuário são determinadas a partir da chave de API.

Exemplos de Requisição

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

Resposta

Resposta de Sucesso (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
    }
}

Campos da Resposta

Campo	Tipo	Descrição
status	string	Sempre "success" para requisições bem-sucedidas
timestamp	string	Carimbo de data/hora do servidor no formato AAAA-MM-DD HH:MM:SS
user_id	integer	ID interno do usuário
user_info.email	string	Endereço de e-mail do usuário
user_info.name	string	Nome de exibição do usuário
user_info.deposit_address	string	Endereço TRON para depósitos
stats.balance	number	Saldo Total TRX - inclui saldo da carteira de depósito + pagamentos pendentes (Robô e Subusuários) - saques pendentes
stats.total_delegations	integer	Número total de delegações de Energy
stats.total_energy_delegated	integer	Unidades totais de Energy delegadas
stats.total_trx_spent	number	Total de TRX gastos em Energy
stats.total_deposit	number	Total de depósitos realizados
stats.avg_rate_sun_energy	number	Taxa média em Sun por unidade de Energy
stats.save_by_netts_percent	number	Porcentagem economizada usando NETTS versus queima de TRX
stats.save_in_dollars	number	Valor em dólares da economia
network_info.trx_price	number	Preço atual do TRX em USD
network_info.network_energy_fee	number	Taxa atual de Energy da rede

Respostas de Erro

Erro de Autenticação (401)

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

Erro Interno do Servidor (500)

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

Limites de Taxa

Os seguintes limites de taxa se aplicam a este endpoint (por endereço IP):

Período	Limite	Descrição
1 minuto	6 requisições	Máximo de 6 requisições por minuto

Cabeçalhos de Limite de Taxa

A API retorna informações de limitação de taxa nos cabeçalhos de resposta:

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

Limite de Taxa Excedido (429)

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

Quando o limite de taxa for excedido, aguarde o tempo especificado no cabeçalho Retry-After antes de fazer a próxima requisição.

Detalhes do Cálculo do Saldo

O Saldo Total TRX Inclui:

O campo stats.balance retorna o Saldo Total TRX, que é calculado como:

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

Componentes:

• Saldo da Carteira de Depósito: Saldo de TRX no endereço de depósito do usuário
• Pagamentos Pendentes: Ganhos em TRX do Robô e de Subusuários aguardando crédito
• Saques Pendentes: Valores em TRX em solicitações de saque pendentes

Observações Importantes:

Importante

• Os TRX de pagamento do Robô e de Subusuários são creditados no endereço de depósito 2 vezes por dia
• Antes do crédito, os TRX de pagamento do Robô e de Subusuários não podem ser usados para compras de Energy
• Para sacar TRX/USDT de pagamentos do Robô e de Subusuários, ative a caixa de seleção no formulário de saque no site

Observações

• Nenhum corpo de requisição necessário - esta é uma requisição GET
• As informações do usuário são determinadas a partir da chave de API fornecida
• Todos os valores de TRX estão em formato decimal
• Os valores de Energy estão em unidades padrão de Energy da TRON
• O carimbo de data/hora está no horário do servidor (UTC)
• Limitação de taxa: Aplicada por endereço IP com múltiplas janelas de tempo
• Código de erro 429: Retornado quando os limites de taxa são excedidos