Withdrawals

Withdrawals take funds off a venue and back to an EVM wallet. Aster, Hyperliquid, Lighter, Robinhood, and Ondo share one prepare/sign/execute flow; Extended has its own quote-based flow.

Prerequisites: an active VOOI API token and the source venue connected. See API Tokens and Use your own keys if you don’t have them yet.

Binance, Bybit, and MEXC expose no withdrawals through VOOI. Move funds out of those venues directly.

1. Prepare

POST /withdraw/prepare takes the exchange, the amount, and the address to withdraw to. Two optional fields are venue-specific:

chainId — the destination chain. Only Aster and Ondo offer a real choice; both default to Arbitrum One (42161).
symbol — the token to withdraw. Only Aster offers a real choice; it defaults to USDC.

curl -X POST https://perps-api.vooi.io/withdraw/prepare \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{ "exchange": "hyperliquid", "amount": "25", "address": "0xYourWalletAddress" }'

Every other venue withdraws to exactly one chain and token, listed in Destination chains and tokens below. Passing a value a venue doesn’t support is rejected rather than quietly ignored. The response always carries a withdrawId to pass to the execute step, a fee, a withdrawLimit, and a signData whose shape depends on the venue:

Venue	`signData`	Sign it as
Hyperliquid	EIP-712 typed data	EIP-712 signature from your main wallet
Aster	EIP-712 typed data	EIP-712 signature from your main wallet
Lighter / Robinhood	A plain string	A plain personal-sign message — not EIP-712
Ondo	`null`	Nothing to sign; pass `"0x"` as the signature

withdrawLimit is the maximum you can withdraw right now, and it is not the same as your balance. On Lighter and Robinhood it is the fast withdrawal ceiling. On Ondo it is your withdrawable margin minus the fee — Ondo debits the fee on top of the amount, not out of it — capped by whatever remains of the period limit.

2. Sign

Sign whatever prepare returned, with the wallet that owns the account.

const signature = await account.signTypedData({
  domain: signData.domain,
  types: signData.types,
  primaryType: signData.primaryType,
  message: signData.message,
});

const signature = await account.signMessage({ message: signData });

// prepare returned signData: null — the destination address is already
// registered with the venue, so there is nothing to sign.
const signature = '0x';

3. Execute

POST /withdraw/execute takes the withdrawId from step 1, the signature from step 2, and the address executing the withdrawal. VOOI submits it to the venue — you don’t broadcast anything on-chain.

curl -X POST https://perps-api.vooi.io/withdraw/execute \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{ "withdrawId": "...", "signature": "0x...", "address": "0xYourWalletAddress" }'

On Ondo the address must match the one the withdrawal was prepared for — a mismatch is rejected. Prepare a fresh withdrawal rather than reusing a withdrawId for a different destination.

Destination chains and tokens

Venue	Chains	Tokens
Hyperliquid	Arbitrum One (`42161`)	USDC
Lighter	Arbitrum One (`42161`)	USDC
Robinhood	Chain `4663`	USDG
Aster	Ethereum (`1`), BNB Chain (`56`), Arbitrum One (`42161`)	`USDC`, `USDT`, `USDC.e`, `USD1`, `USDF`, `lisUSD`
Ondo	Ethereum (`1`), Arbitrum One (`42161`)	USDC

Robinhood settles in USDG on its own chain rather than USDC on Arbitrum, matching how it takes deposits. An unsupported chainId or symbol is rejected with a message naming what the venue does support — see Errors.

Tracking the result

There is no withdrawal-status endpoint. Confirm the debit the same way you confirm a deposit credit: watch the venue balance on GET /exchange/accounts, or subscribe to the accounts event on the updates stream. Arrival in your wallet depends on the destination chain.

Getting Started

Trading

Connect an Exchange

Points & rewards

Brokers

1. Prepare

2. Sign

3. Execute

Destination chains and tokens

Tracking the result

Next steps

Extended withdrawals

Transfers between exchanges

​1. Prepare

​2. Sign

​3. Execute

​Destination chains and tokens

​Tracking the result

​Next steps

Extended withdrawals

Transfers between exchanges

1. Prepare

2. Sign

3. Execute

Destination chains and tokens

Tracking the result

Next steps