Skip to content
🌐Network: Mainnet▼

Deposits & Withdrawals ​

How to move assets into and out of an o2 trading account.

Deposit ​

Deposits move assets into your trading account contract so you can place orders.

Mainnet Deposits ​

The easiest mainnet path is the o2 trading UI. It supports deposits from EVM chains such as Base and Ethereum, Fuel wallets, and the fast-bridge flow.

For the underlying bridge protocol, see Fuel Fast Bridge.

Testnet and Devnet Deposits ​

On testnet and devnet, the easiest way to fund a trading account is the faucet:

  • Mint to the owner wallet while setting up.
  • Mint directly to the trade_account_id after account creation.
  • SDK helpers such as setupAccount() / setup_account() handle this in the quick starts.

See Testing on Testnet for faucet and whitelisting notes.

Withdraw ​

Withdrawals move funds out of the trading account. There are two different paths, and they should not be treated as interchangeable.

Fuel Ignition Withdrawal ​

API endpoint:

http
POST /v1/accounts/withdraw

This endpoint withdraws from the o2 trading account to a Fuel Ignition destination only. It does not bridge to Base, Ethereum, or another EVM chain.

See Withdraw Assets for parameters and the interactive endpoint reference.

Important rules:

  • Withdrawals require the owner key.
  • Session keys cannot withdraw funds.
  • Open orders may lock funds until they are cancelled and settled.
  • With the typed signature variant, withdrawals can use a parallel_nonce for concurrent in-flight requests.

EVM Withdrawal Through Fast Bridge ​

To move funds from o2/Fuel to an EVM destination chain, use the Fast Bridge withdrawal flow instead of POST /v1/accounts/withdraw.

FastBridgeClient prepares an owner-signed Fuel transaction that calls AssetRegistry.withdraw_via_fast_bridge_with_fee. It requires a funded Fuel wallet, destination-chain details, an EVM recipient, and a gas-oracle fee quote. If the assets are still held by an o2 trading account, first use the standard SDK withdrawal to move them to the owner wallet, then submit the Fast Bridge withdrawal. The trading UI can coordinate these steps for you.

Implementation references:

Mainnet Funding ​

Mainnet has no faucet. Use production assets and the trading UI or bridge flows.

Relevant references:

Testnet Funding ​

Testnet uses test assets such as fUSDC, fETH, fFUEL, and related faucet-minted assets.

Use testnet for integration testing, but expect thin or one-sided order books. Check depth before placing market-crossing orders.

Fast Bridge ​

The Fast Bridge moves assets between EVM chains and Fuel. It is live on mainnet with Base and Ethereum outposts.

Use the Fast Bridge page for architecture, deposit flow, withdrawal flow, and supported chain status.

SDK Support ​

The SDK quick starts include deposit and withdrawal examples:

All three SDKs provide FastBridgeClient on Mainnet and Testnet. Fast Bridge is not available on Devnet.

Optional AI-agent guidance is available in the installable Fast Bridge deposit and withdrawal skills. Treat the SDK quick starts above as the canonical application documentation.