Создать вывод
POST /api/v1/account/withdrawalТело запроса
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/withdrawalsResponse
Статусы выводов
Выводы, созданные через API-ключ, отправляются сразу и не проходят через
scheduled. У строк, созданных в веб-кабинете, есть поле execute_after — момент отправки, если вывод не отменили раньше.
Блокировка вывода после смены email
В течение 24 часов после смены email аккаунта создание вывода отклоняется с кодом403 и ошибкой WITHDRAWAL_EMAIL_COOLDOWN. В ответе приходит retry_after_seconds — сколько секунд осталось до разблокировки:
Response
withdraw. Если вы не меняли email аккаунта — немедленно обратитесь в поддержку.