Webhook event
Crypto Withdrawal Created
CRYPTO_WITHDRAWAL_CREATEDFired when a crypto withdrawal is initiated. The funds are reserved and the withdrawal is awaiting the wallet owner signature.
Body
application/json
idstringrequiredUnique event identifier for idempotency
typestringrequiredWebhook event type
CRYPTO_WITHDRAWAL_CREATEDdataobjectrequiredShow child attributes
idstring<uuid>requiredUnique withdrawal identifier
accountIdstring<uuid>requiredAccount the funds are withdrawn from
chainIdstringrequiredBlockchain network the transfer happens on
ETHEREUM_MAINNETETHEREUM_SEPOLIABASE_MAINNETBASE_SEPOLIAARBITRUM_ONE_MAINNETARBITRUM_ONE_SEPOLIAPOLYGON_MAINNETPOLYGON_AMOYSOLANA_MAINNETSOLANA_DEVNETassetobjectrequiredAsset metadata
Show child attributes
symbolstringrequiredAsset symbol
namestring | nullrequiredFull asset name
decimalsintegerrequiredNumber of decimal places
logoUristring | nullrequiredURI to asset logo image
amountstringrequiredGross amount requested, with decimals applied. The fee is taken out of this rather than charged on top.
netAmountstringrequiredAmount the destination receives: the gross less the fee
feeobjectrequiredFee charged for the withdrawal, fixed at the time it was requested
Show child attributes
amountstringrequiredFee retained, with decimals applied
assetobjectrequiredAsset metadata
Show child attributes
symbolstringrequiredAsset symbol
namestring | nullrequiredFull asset name
decimalsintegerrequiredNumber of decimal places
logoUristring | nullrequiredURI to asset logo image
destinationAddressstringrequiredAddress the funds are sent to
statusstringrequiredCurrent withdrawal status
PENDING_SIGNATUREPROCESSINGCOMPLETEDEXPIREDCANCELLEDFAILEDfailureReasonstring | nullrequiredWhat went wrong. Set only when the status is FAILED.
REJECTED_BY_COMPLIANCEACCOUNT_RESTRICTEDTRANSACTION_FAILEDtransactionIdstring | nullrequiredOn-chain transaction identifier. Present once the transfer has been submitted to the network, which happens while the status is still PROCESSING.
expiresAtstringrequiredWhen the signature window closes. Past this point the withdrawal is closed and the funds become spendable again.
completedAtstring | nullrequiredWhen the transfer was observed to be irreversible on-chain, which is when the status became COMPLETED. Null until then.
createdAtstringrequiredISO 8601 creation timestamp
updatedAtstringrequiredISO 8601 last update timestamp
Response
200Webhook received successfully. Return any 2xx status to acknowledge.
