Создание вывода

Создаёт вывод по ранее полученному quote.

POST/withdrawals

Системная информация

API-ключ: Требуется
Rate Limit: ∞

Перед созданием получите quoteId через расчёт комиссии (POST /withdrawals/calculate).

Body-параметры

Параметр	Тип	Обязательный	Описание
quoteId	string (UUID)	Да	Значение из ответа quote.
coinCode	string	Да	Как в quote.
networkCode	string	Да	Как в quote.
amount	string	Да	Как в quote.
destinationAddress	string	Да	Как в quote.

curl -X POST "https://api.atomic.wallet/api/v1/withdrawals" \
  -H "x-api-key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "quoteId": "42792728-4d29-4d0a-bcb5-4aed46642fce",
  "coinCode": "USDT",
  "networkCode": "ethereum",
  "amount": "10.000000",
  "destinationAddress": "0x977e259e69ad9bfd882ceb411afaebb4a66e4020"
}'

{
  "uuid": "0f8c2a2e-7d0c-4f4b-9a51-1c2f6b8e4d10",
  "coinCode": "USDT",
  "networkCode": "ethereum",
  "amount": "10.000000",
  "recipientAmount": "9.900000",
  "debitAmount": "10.000000",
  "address": "0x977e259e69ad9bfd882ceb411afaebb4a66e4020",
  "status": "requested",
  "networkFee": "0.100000",
  "txid": null,
  "createdAt": "2026-10-07T12:01:00.000Z",
  "updatedAt": "2026-10-07T12:01:00.000Z",
  "broadcastedAt": null,
  "confirmedAt": null
}

Описание полей ответа

Параметр	Тип	Описание
uuid	string	UUID вывода.
coinCode	string	Код криптовалюты.
networkCode	string	Код блокчейн-сети.
amount	string	Запрошенная сумма вывода.
recipientAmount	string	Сумма, которую получит получатель.
debitAmount	string	Сумма списания с баланса.
address	string	Адрес получателя.
status	string	Статус вывода, см. «Статусы».
networkFee	string	Сетевая комиссия.
txid	string \| null	Хеш транзакции в блокчейне. Появляется после отправки в сеть.
createdAt	string	Дата создания (ISO 8601).
updatedAt	string	Дата последнего изменения (ISO 8601).
broadcastedAt	string \| null	Дата отправки транзакции в сеть (ISO 8601).
confirmedAt	string \| null	Дата подтверждения (ISO 8601).

Ответ 201 означает, что вывод принят в обработку. Минимальная сумма — 0.001 в единицах монеты.

Идемпотентность

Ситуация	Результат
Создание вывода	Баланс и права проверяются повторно.
Таймаут, результат неизвестен	Повторите тот же запрос с тем же `quoteId`. Новый quote до выяснения результата не запрашивайте.
Вывод уже создан	Повтор возвращает существующий вывод, даже после истечения quote.
Другие параметры при том же `quoteId`	`400 WITHDRAWAL_QUOTE_MISMATCH`
Вывод отменён или неуспешен	Под тем же `quoteId` заново не создаётся.
Quote истёк до создания	`400 WITHDRAWAL_QUOTE_INVALID_OR_EXPIRED`: запросите новый quote, комиссия может измениться.
Заголовок `Idempotency-Key`	Не используется.

Возможные ошибки

HTTP	Код	Описание
400	`WITHDRAWAL_ASSET_UNAVAILABLE`	Актив для вывода недоступен.
400	`WITHDRAWAL_DESTINATION_INVALID`	Некорректный адрес получателя.
400	`WITHDRAWAL_AMOUNT_INVALID`	Некорректная сумма вывода.
400	`WITHDRAWAL_AMOUNT_BELOW_MINIMUM`	Сумма вывода ниже минимальной.
400	`WITHDRAWAL_BALANCE_INSUFFICIENT`	Недостаточно средств на балансе.
400	`WITHDRAWAL_QUOTE_INVALID_OR_EXPIRED`	Quote недействителен или истёк.
400	`WITHDRAWAL_QUOTE_MISMATCH`	Параметры вывода не совпадают с quote.
400	`WITHDRAWAL_QUOTE_ALREADY_USED`	Quote уже использован.
403	`ACCOUNT_ACCESS_DENIED`	Выводы отключены для ключа (`withdrawalsEnabled=false`).

← НазадОбзор Далее →Расчёт комиссии