Skip to main content

Withdrawals

Create and poll crypto withdrawals on the company omnibus wallet.

MethodPathScope
POST/partner/v1/withdrawals/previewwithdrawals:write
POST/partner/v1/withdrawalswithdrawals:write
GET/partner/v1/withdrawals?clientOrderId=…withdrawals:read

Preview​

Validates limits, balance, deposit holds, and address without locking funds.

{
"symbol": "USDT",
"network": "BSC",
"amount": "5",
"receiverAddress": "0x742d35Cc6634C0532925a3b8D4C9db96C4b4d8b6"
}

Response includes amount, fee, and transferAmount.

Create​

{
"symbol": "USDT",
"network": "BSC",
"amount": "5",
"receiverAddress": "0x742d35Cc6634C0532925a3b8D4C9db96C4b4d8b6",
"externalUserId": "user-42",
"clientOrderId": "wd_9f3c2a"
}
  • Debits the company actor bound to the key (amount = transfer + fee).
  • externalUserId is correlation-only (your end-user id).
  • clientOrderId is the idempotency key. Retries with the same value return the original withdrawal.
  • No SMS OTP — API key + withdrawals:write is the authorization.

Lookup​

Poll by your idempotency key: GET /partner/v1/withdrawals?clientOrderId=wd_9f3c2a

Response fields include amount, fee, transferAmount, status, refId, txHash, and timestamps.

Terminal status​

When a withdrawal reaches done or failed, Danatorex also delivers a signed webhook (withdrawal.terminal). You may still poll GET endpoints. See Webhooks.