Skip to main content
Scope: withdraw.

Create withdrawal

amount is the sum sent to to_address (excluding IMBA fee). Available balance must cover amount + fee.

Response 202

Status lifecycle

Track with:
  • Webhook withdrawal.status_changed
  • POST /api/partner/document_get with ext_id

Errors

Daily withdraw caps may apply per tenant (withdraw_limit_exceeded). See Rate limits. There is no partner cancel-withdrawal endpoint. Terminal states include failed and cancelled (provider / ops). IMBA withdraw fee is our charge, not blockchain gas. Create returns an upper estimate in fee (code default 2 USDT). After planning it can fall to 1 USDT (code default) if the recipient already holds USDT. Budget for the fee on the create response.