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	ціле число	Внутрішній ідентифікатор користувача
user_info.email	рядок	Адреса електронної пошти користувача
user_info.name	рядок	Відображуване ім'я користувача
user_info.deposit_address	рядок	TRON-адреса для депозитів
stats.balance	число	Доступний баланс TRX — сума, з якої оплачуються замовлення енергії; очікувані виведення вже вираховані, виплати Robot і субкористувачів не входять до зарахування
stats.total_delegations	ціле число	Загальна кількість делегувань енергії
stats.total_energy_delegated	ціле число	Загальна кількість делегованих одиниць енергії
stats.total_trx_spent	число	Загальна кількість TRX, витрачених на енергію
stats.total_deposit	число	Не заповнюється: завжди 0. Історія депозитів — в історії гаманця в особистому кабінеті
stats.avg_rate_sun_energy	число	Середня ставка в Sun за одиницю енергії
stats.save_by_netts_percent	число	Відсоток економії при використанні NETTS у порівнянні зі спалюванням TRX
stats.save_in_dollars	число	Сума економії в доларах
network_info.trx_price	число	Поточна ціна TRX в USD
network_info.network_energy_fee	число	Поточна комісія мережі за енергію

Відповіді з помилками

Помилка автентифікації (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, перш ніж робити наступний запит.

Деталі розрахунку балансу

Що містить stats.balance:

Поле stats.balance повертає доступний баланс акаунта в TRX. За цією сумою перевіряються і з неї оплачуються замовлення енергії.

• Очікувані виведення: уже вираховані — заявка на виведення зменшує баланс одразу під час створення
• Виплати Robot і субкористувачів: не входять, доки не зараховані на баланс

Важливі примітки:

Важливо

• TRX виплат Robot та субкористувачів зараховуються на депозитну адресу 2 рази на день
• До зарахування TRX виплат Robot та субкористувачів не можуть бути використані для купівлі Energy
• Щоб вивести TRX/USDT виплат Robot та субкористувачів, активуйте чекбокс у формі виведення на сайті

Примітки

• Тіло запиту не потрібне — це GET-запит
• Інформація про користувача визначається за наданим API-ключем
• Усі значення TRX подано в десятковому форматі
• Значення Energy подано в стандартних одиницях Energy TRON
• Часова мітка вказана за часом сервера (UTC)
• Обмеження швидкості: Застосовується для кожної IP-адреси з декількома часовими вікнами
• Код помилки 429: Повертається при перевищенні лімітів запитів