Аккаунт — Справочник API

Информация об аккаунте, баланс и депозитные адреса.

Сгенерировано из openapi.yaml во время сборки. Базовый URL https://api.tenergy.me/v1 или https://api-nile.tenergy.me/v1 в сети Nile (Окружения). Каждый запрос ниже подписывается в соответствии с разделом Аутентификация, если в строке Аутентификация не указано иное.

Информация об аккаунте

GET /v1/account · getAccount

Аутентификация: API-ключ (HMAC) или bootstrap-токен.

Идентификатор, балансы, депозитные адреса, действующие лимиты и счетчики за все время.

Также доступен по bootstrap-токену (Authorization: Bearer abt_…), что позволяет в процессе регистрации ожидать первого подтвержденного депозита без API-ключа.

Ответы

Поля ответа (Account)

Пример ответа 200 из контракта (значения для иллюстрации):

{
  "id": "acc_01J9Z4K2M7Q8",
  "brand": "tenergy.me",
  "network": "mainnet",
  "label": "Acme payments",
  "status": "active",
  "balance_sun": 1250400000,
  "balance_usdt": 0,
  "reserved_sun": 0,
  "deposit_addresses": [{"currency":"TRX","address":"TDepositAddressExample1111111111111"}],
  "limits": {"max_order_energy":3000000,"max_batch_receivers":100,"orders_per_second":30},
  "totals": {
    "deposited_sun": 5000000000,
    "spent_sun": 3749600000,
    "refunded_sun": 0,
    "orders_created": 1842,
    "energy_delegated": 119730000
  },
  "created_at": "2026-04-02T09:11:00.000Z"
}

Изменение отображаемого имени аккаунта

PATCH /v1/account · updateAccount

Аутентификация: Cookie сессии панели управления + X-CSRF-Token.

Название аккаунта, отображаемое во всех интерфейсах. Значение null сбрасывает его до сокращенного адреса владельца.

Операция сессии панели управления (роль владельца owner).

Тело запроса

JSON (AccountPatch), обязательно.

Ответы

Поля ответа (Account)

Те же поля, что в ответе GET /v1/account.

Только балансы

GET /v1/balance · getBalance

Аутентификация: API-ключ (HMAC).

Облегченный ответ для клиентов, опрашивающих баланс перед каждым заказом. Значительно дешевле по ресурсам, чем /account.

Ответы

Поля ответа (Balance)

Пример ответа 200 из контракта (значения для иллюстрации):

{
  "balance_sun": 1250400000,
  "balance_usdt": 0,
  "reserved_sun": 0,
  "available_sun": 1250400000,
  "as_of": "2026-09-11T18:04:05.123Z"
}

Депозитные адреса аккаунта

GET /v1/deposit-addresses · listDepositAddresses

Аутентификация: API-ключ (HMAC).

Собственные депозитные адреса аккаунта: персональный TRON-адрес, принадлежащий исключительно этому аккаунту (memo не требуется, поле memo всегда null). Две строки с одним и тем же адресом: TRX и USDT (TRC-20), который конвертируется в TRX по текущему курсу rate_now за вычетом spread_bps.

Депозит зачисляется после заданного числа подтверждений сети (confirmations_required) и отправляет вебхук balance.credited.

Ответы

Поля ответа

Пример ответа 200 из контракта (значения для иллюстрации):

{
  "data": [
    {
      "currency": "TRX",
      "address": "TDepositAddressExample1111111111111",
      "memo": null,
      "confirmations_required": 19
    }
  ],
  "retired": [
    {
      "address": "TRetiredAddressExample111111111111",
      "retired_at": "2026-09-20T10:00:00.000Z",
      "credited_until": "2026-10-20T10:00:00.000Z"
    }
  ],
  "rotation": {
    "by": "support",
    "min_interval_days": 7,
    "max_per_window": 3,
    "window_days": 90,
    "retired_credit_days": 30
  }
}

Выписка по балансу аккаунта (журнал)

GET /v1/ledger · listLedger

Аутентификация: Cookie сессии панели управления + X-CSRF-Token.

Все операции, изменившие баланс аккаунта (новые сначала): депозиты, списания за заказы, возвраты и комиссии. amount_sun / amount_usdt отражают чистое изменение баланса (положительное при зачислении, отрицательное при списании).

Доступно только для сессии панели управления (роль viewer или выше).

Параметры

Ответы

Поля ответа

Пример ответа 200 из контракта (значения для иллюстрации):

{
  "data": [
    {
      "id": "jrn_01K5Y8Q2V9M3ZP4T7R1A2B3C4D",
      "kind": "order_charge",
      "amount_sun": -3900000,
      "amount_usdt": 0,
      "order_id": "ord_01K5Y8Q2V9M3ZP4T7R1A2B3C4E",
      "deposit": null,
      "created_at": "2026-09-25T10:12:04.000Z"
    },
    {
      "id": "jrn_01K5Y7A1B2C3D4E5F6G7H8J9K0",
      "kind": "deposit",
      "amount_sun": 50000000,
      "amount_usdt": 0,
      "order_id": null,
      "deposit": {
        "txid": "9f3c1e7a2b4d6f8091a3c5e7f9b1d3f5a7c9e1b3d5f7a9c1e3b5d7f9a1c3e5b7",
        "sender": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
        "block_number": 61000123,
        "status": "credited",
        "confirmations_required": 19
      },
      "created_at": "2026-09-25T09:58:40.000Z"
    }
  ],
  "next_cursor": null
}

Адресная книга аккаунта

GET /v1/account/addresses · listAddressBook

Аутентификация: Cookie сессии панели управления + X-CSRF-Token.

Сохраненные адреса получателей (до 100 записей).

Доступно только для сессии панели управления (роль viewer или выше).

Ответы

Поля ответа

Пример ответа 200 из контракта (значения для иллюстрации):

{
  "data": [
    {
      "id": "adr_01K5Y9B7C8D9E0F1G2H3J4K5M6",
      "label": "Payouts hot wallet",
      "address": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
      "created_at": "2026-09-25T10:20:00.000Z",
      "updated_at": "2026-09-25T10:20:00.000Z"
    }
  ],
  "limit": 100,
  "used": 1
}

Сохранение адреса в книгу

POST /v1/account/addresses · saveAddressBookEntry

Аутентификация: Cookie сессии панели управления + X-CSRF-Token.

Добавляет адрес с указанной меткой. Адрес уникален в рамках аккаунта: повторное сохранение обновляет метку и не занимает новый слот.

Доступно только для сессии панели управления (роль editor или выше).

Тело запроса

JSON (AddressBookRequest), обязательно.

Ответы

Поля ответа (AddressBookEntry)

Удаление адреса из книги

DELETE /v1/account/addresses/{entryId} · deleteAddressBookEntry

Аутентификация: Cookie сессии панели управления + X-CSRF-Token.

Немедленно освобождает слот в адресной книге. Требуется сессия с ролью editor.

Параметры

Ответы

Серверная аналитика по заказам

GET /v1/account/stats · getAccountStats

Аутентификация: API-ключ (HMAC) или cookie сессии панели управления + X-CSRF-Token.

Агрегированная статистика для графиков и экранов аналитики, рассчитанная на стороне сервера за временной диапазон [from, to):

Хранение данных: 13 месяцев. Требуется scope orders.read или роль в панели viewer.

Параметры

Ответы

Поля ответа (AccountStats)

Пример ответа 200 из контракта (значения для иллюстрации):

{
  "from": "2026-09-23T00:00:00.000Z",
  "to": "2026-09-25T00:00:00.000Z",
  "requested_from": "2026-09-23T00:00:00.000Z",
  "clamped": false,
  "retention_months": 13,
  "bucket": "day",
  "utc_offset_minutes": 0,
  "totals": {"orders":3,"energy":196000,"spent_sun":11760000,"avg_price_sun_per_65k":3900000},
  "series": [
    {"date":"2026-09-23","orders":1,"energy":65000,"spent_sun":3900000},
    {"date":"2026-09-24","orders":2,"energy":131000,"spent_sun":7860000}
  ],
  "weekday_hour": [[0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0]],
  "top_receivers": [
    {
      "receiver": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
      "orders": 2,
      "energy": 131000,
      "spent_sun": 7860000
    }
  ]
}