Методы API
Вывод на внешний адрес
POST
/api/v1/withdrawalsНужный scope: withdrawals:write| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
amount | string | да | Списывается с баланса целиком, минимум 10 |
currency | string | нет | USDT по умолчанию. Монета должна быть в сети вывода |
network | string | да | tron, ton, solana, sim |
address | string | да | Адрес получателя, до 128 символов. Проверяется по формату сети |
memo | string | нет | До 128 символов. TON: текстовый comment jetton-перевода (его читают биржи). Solana: инструкция SPL Memo. TRON: у TRC-20 memo нет, запрос получит MEMO_NOT_SUPPORTED |
- С баланса списывается
amount, получатель получаетnet_amount=amount − fee.feeэто комиссия сети на момент заявки: TON 0.3, Solana 0.5, Simnet 0.2 (фиксированные), TRON от 3 (следует за курсом TRX, текущее значение вwithdrawal_feeиз/currencies). - Сумма сразу переходит из
availableвheld. - Вывод может уйти несколькими переводами в сети, если нужной суммы нет на одном адресе шлюза. Получатель тогда видит несколько входящих транзакций, в сумме ровно
net_amount.feeот числа переводов не зависит.txids: txid всех переводов,txid: первого из них. - Всегда передавайте
Idempotency-Key: повтор после таймаута без ключа создаст второй вывод. - Проверки по порядку: сеть, монета, формат адреса, минимум 10 и сумма больше комиссии, чёрный список. Дальше только mainnet: подтверждённый email (
EMAIL_NOT_VERIFIED), лимит закрытой беты на аккаунт (BETA_LIMIT), порог без верификации на аккаунт (KYC_REQUIRED, если KYC включён), дневной лимит приложения (по умолчанию 20 000 в сутки, меняет оператор), лимит нового аккаунта (не действует, если оператор задал аккаунту индивидуальный лимит). Последним баланс. Лимиты считаются по выводам за последние 24 часа в статусахpending,review,processing,completed; лимиты беты и KYC: по всем приложениям аккаунта.
Ручная проверка (только mainnet). Вывод получает статус review и ждёт решения оператора, если выполнено любое условие:
- сумма от 2000;
- сумма выводов приложения за последний час вместе с этим выводом больше 5000;
- аккаунту меньше 7 дней;
- от порога AML (по умолчанию 1000) адрес получателя проверяется AML-провайдером, и проверка показала высокий риск или провайдер не ответил.
В testnet-режиме ручной проверки, AML и лимитов нет.