Эндпоинты API - Документация API

Базовый URL

Продакшн: https://api.usdtlowfee.com

Общие соглашения

Единицы измерения

• sun: 1 TRX = 1 000 000 sun (все поля сумм используют sun)
• energyValue: единица энергии (число int64)
• durationHours: часы (целое число)

Типы данных

• Поля ID: число int64 (snowflake ID)
• Поля сумм: число int64 (суффикс *Sun, например, balanceSun, priceSun)
• Поля времени: строка (формат ISO8601 UTC, например, "2025-01-15T10:30:00Z")
• Логические поля: true/false

Формат ответа

• Успех: { "data": {...}, "meta": {...} } (meta опционально)
• Ошибка: { "error": { "code": "...", "message": "..." } }

Управление аккаунтом

Запрос баланса кошелька и информации о пользователе

GET /v1/wallet/balance

Получить баланс

Получить текущий баланс кошелька

Пример ответа:

{
  "data": {
    "balanceSun": 1000000,
    "frozenSun": 0,
    "totalSun": 1000000
  }
}

GET /v1/users/me

Информация о пользователе

Получить основную информацию о текущем пользователе

Пример ответа:

{
  "data": {
    "id": 123456,
    "email": "user@example.com",
    "emailVerified": true,
    "createdAt": "2025-01-01T00:00:00Z"
  }
}

Управление заказами

Создание и запрос заказов энергии

POST /v1/energy/orders

Создать заказ

Создать заказ аренды энергии для указанного адреса (в настоящее время поддерживается только тип manual)

Параметры запроса:

Параметр	Тип	Обязательный	Описание
type	string	Да	Тип заказа, в настоящее время поддерживается только "manual"
data.tronAddress	string	Да	TRON-адрес для получения энергии (34 символа, начинается с T)
data.energyValue	int64	Да	Количество энергии (число, минимум 32000, рекомендуется 65000 для переводов USDT)
data.durationHours	int	Да	Длительность аренды (часы, допустимые значения: 1, 24, 72, 168, 336, 720)

Пример запроса:

{
  "type": "manual",
  "data": {
    "tronAddress": "TYour1Address2Here3...",
    "energyValue": 65000,
    "durationHours": 1
  }
}

Пример ответа:

{
  "data": {
    "id": 1234567890,
    "userId": 9876543210,
    "tronAddress": "TYour1Address2Here3...",
    "energyValue": 65000,
    "durationHours": 1,
    "priceSun": 3000000,
    "priceTrx": 3.0,
    "orderType": "manual",
    "status": "processing",
    "createdAt": "2025-01-15T10:30:00Z",
    "updatedAt": "2025-01-15T10:30:00Z",
    "statusUpdatedAt": "2025-01-15T10:30:00Z",
    "canTransitionTo": ["completed", "failed"]
  }
}

GET /v1/energy/orders/:id

Получить заказ

Запросить детали заказа по ID заказа

Пример ответа:

{
  "data": {
    "id": 1234567890,
    "userId": 9876543210,
    "tronAddress": "TYour1Address2Here3...",
    "energyValue": 65000,
    "durationHours": 1,
    "priceSun": 3000000,
    "priceTrx": 3.0,
    "orderType": "manual",
    "status": "completed",
    "txid": "abc123...",
    "createdAt": "2025-01-15T10:30:00Z",
    "completedAt": "2025-01-15T10:30:05Z",
    "updatedAt": "2025-01-15T10:30:05Z",
    "statusUpdatedAt": "2025-01-15T10:30:05Z",
    "canTransitionTo": []
  }
}

GET /v1/energy/orders

Список заказов

Запросить список заказов (поддерживается пагинация и фильтрация)

Параметры запроса:

Параметр	Тип	Обязательный	Описание
offset	number	Нет	Смещение, по умолчанию 0
limit	number	Нет	Элементов на странице, по умолчанию 20, максимум 100
status	string	Нет	Фильтр по статусу заказа: processing, completed, failed

Пример ответа:

{
  "data": {
    "orders": [
      {
        "id": 1234567890,
        "userId": 9876543210,
        "tronAddress": "TYour1...",
        "energyValue": 65000,
        "durationHours": 1,
        "priceSun": 3000000,
        "priceTrx": 3.0,
        "orderType": "manual",
        "status": "completed",
        "createdAt": "2025-01-15T10:30:00Z",
        "updatedAt": "2025-01-15T10:30:05Z",
        "statusUpdatedAt": "2025-01-15T10:30:05Z",
        "canTransitionTo": []
      }
    ],
    "total": 100,
    "offset": 0,
    "limit": 20
  }
}

Управление адресами

Управление часто используемыми адресами получения

POST /v1/addresses

Добавить адрес

Сохранить новый адрес

Пример запроса:

{
  "tronAddress": "TYour1Address2Here3...",
  "label": "Main Wallet",
  "isDefault": false
}

Пример ответа:

{
  "data": {
    "id": 1,
    "tronAddress": "TYour1Address2Here3...",
    "label": "Main Wallet",
    "isDefault": false,
    "usageCount": 0,
    "createdAt": "2025-01-01T00:00:00Z"
  }
}

GET /v1/addresses

Список адресов

Получить список сохраненных адресов

Пример ответа:

{
  "data": {
    "addresses": [
      {
        "id": 1,
        "tronAddress": "TYour1Address2Here3...",
        "label": "Main Wallet",
        "isDefault": true,
        "usageCount": 5,
        "lastUsedAt": "2025-01-15T10:30:00Z",
        "createdAt": "2025-01-01T00:00:00Z"
      }
    ],
    "total": 1
  }
}

GET /v1/addresses/:id

Получить детали адреса

Запросить информацию об одном адресе

Пример ответа:

{
  "data": {
    "id": 1,
    "tronAddress": "TYour1Address2Here3...",
    "label": "Main Wallet",
    "isDefault": true,
    "usageCount": 5,
    "lastUsedAt": "2025-01-15T10:30:00Z",
    "createdAt": "2025-01-01T00:00:00Z"
  }
}

PUT /v1/addresses/:id/label

Обновить метку адреса

Изменить метку адреса

Пример запроса:

{
  "label": "New Label"
}

Пример ответа:

{
  "data": {
    "id": 1,
    "tronAddress": "TYour1Address2Here3...",
    "label": "New Label",
    "isDefault": false,
    "usageCount": 3,
    "lastUsedAt": "2025-01-15T10:30:00Z",
    "createdAt": "2025-01-01T00:00:00Z"
  }
}

PUT /v1/addresses/:id/default

Установить адрес по умолчанию

Установить указанный адрес в качестве адреса получения по умолчанию

Пример ответа:

// HTTP 204 No Content
// Без тела ответа

Возвращает код статуса 204 без содержимого при успехе.

DELETE /v1/addresses/:id

Удалить адрес

Удалить сохраненный адрес