Перейти к основному содержанию

Создать вывод

POST /api/v1/account/withdrawal
Выводит TRX на любой адрес TRON. Комиссия: 1 TRX.

Тело запроса

string
обязательно
Адрес TRON назначения
string
обязательно
Сумма вывода в TRX
string
TRX (по умолчанию) или USDT. Для USDT в amount_trx передаётся сумма в USDT.
string
Код 2FA (если 2FA включена)

Заголовки

string
Необязательный, до 64 символов. Передавайте новый ключ (например, UUID) с каждым новым выводом и тот же ключ, когда повторяете запрос, ответ на который не получили, — повтор вернёт первый вывод, а не создаст второй.

Безопасный повтор

  • Тот же ключ с теми же to_address, amount_trx и currency возвращает 200 с выводом, который создал первый запрос, в его текущем состоянии. Второго списания нет.
  • Тот же ключ с другим телом запроса отклоняется с 422 и кодом IDEMPOTENCY_KEY_REUSED; ключ длиннее 64 символов — с 422 и IDEMPOTENCY_KEY_TOO_LONG. Ключи действуют в пределах вашего аккаунта и не истекают — не используйте один ключ для другого вывода.
  • Незавершённый вывод (pending, scheduled или processing) может быть только один: новый запрос, пока он есть, получит 400 с You already have a pending withdrawal.
  • После вывода, созданного с Idempotency-Key, следующий можно создать через 5 секунд; без заголовка пауза остаётся 60 секунд (429, см. Лимиты запросов).

Пример

Response

Список выводов

GET /api/v1/account/withdrawals
Возвращает историю ваших выводов.
Response

Статусы выводов

Выводы, созданные через API-ключ, отправляются сразу и не проходят через scheduled. У строк, созданных в веб-кабинете, есть поле execute_after — момент отправки, если вывод не отменили раньше.

Блокировка вывода после смены email

В течение 24 часов после смены email аккаунта создание вывода отклоняется с кодом 403 и ошибкой WITHDRAWAL_EMAIL_COOLDOWN. В ответе приходит retry_after_seconds — сколько секунд осталось до разблокировки:
Response
Блокировка действует для сессий любого типа, включая API-ключи с правом withdraw. Если вы не меняли email аккаунта — немедленно обратитесь в поддержку.