Skip to main content
POST
Create a withdrawal
Withdraws from a subaccount held by Matching with one signed Action. The venue pays the gas and sends the tokens to owner. The account stays in Matching, so trading continues.

Signing the action

Sign an Action against the Matching domain: asset is the asset your balance is held in, not the token paid out: Accounts opened before 2026-10-04 can also withdraw the retired wrapped USDC 0x364058aFF6f36E01505fB2Cc870f8B6BD4835e84 and wrapped cNGN 0x9D806fD040a719D27a8E5E77dc5aE0ED1e089493. amount uses the token’s 6 decimals: 1 USDC is 1000000. Send the fields as strings, with data as hex:

Errors

The outcome

A 200 carries accepted, tx_hash, receipt_status and block_number. receipt_status: "timeout" means broadcast but not yet confirmed, so watch the hash.
After a 502, check your balance before signing another withdrawal: a second signed withdrawal is a second withdrawal. Resending the same signed request is safe.

Body

application/json
action
object
required

A Matching Action for the WithdrawalModule, signed with EIP-712 against the Matching domain.

signature
string
required

EIP-712 signature by signer: 65 bytes, or longer for an ERC-1271 wallet.

Response

Submitted. receipt_status timeout means broadcast but not yet confirmed.

accepted
boolean
required

True once mined successfully.

tx_hash
string
required
receipt_status
enum<string>

timeout: broadcast, not yet confirmed.

Available options:
success,
reverted,
timeout
block_number
string