v1

latestOpenAPI 3.0.02026-07-2656110201.6 KB
Withdrawals

Submit a Withdrawal

Submits a co-signed transaction for broadcast. Path param is the withdrawalDetailId from prepare (not the config id). No authentication required (rate-limited). Submit is idempotent for records already past QUOTED.

post/v1/withdraw/{withdrawalDetailId}/submit

Path parameters

withdrawalDetailIdstring required

The per-request withdrawal detail ID returned by prepare.

Request body

tokenstring required

JWT from the prepare response.

signedTxstring required

Signed payload for the lane returned by prepare. For raw on Solana: base64 co-signed VersionedTransaction. For userop on EVM: JSON with signature and optional authorization. For hypercore: EIP-712 signature over typedData.

Response

Withdrawal submitted successfully.

withdrawalDetailIdstring
txHashstring nullable

On-chain transaction signature. Null only if broadcast was rejected.

state'QUOTED' | 'SUBMITTING' | 'SUBMITTED' | 'BRIDGING' | 'COMPLETED' | 'FAILED' | 'FAILED_EXPIRED' | 'EXPIRED' | 'REFUNDED_BY_PROVIDER'
broadcastAck'acknowledged' | 'unacknowledged' | 'rejected' nullable

acknowledged = confirmed; unacknowledged = sent, keep polling; rejected = terminal failure.