Skip to content
🌐Network: Mainnet

Testing on Testnet

Use testnet to validate wallet, account, session, order, WebSocket, and withdrawal flows before mainnet.

Testnet URLs

ComponentURL
REST APIhttps://api.testnet.o2.app
WebSocketwss://api.testnet.o2.app/v1/ws
Fuel RPChttps://testnet.fuel.network/v1/graphql
Faucethttps://fuel-o2-faucet.vercel.app/api/testnet/mint-v2

Faucet

The faucet mints test assets only. It is not available on mainnet.

Common flow:

  1. Mint to your owner wallet.
  2. Create a trading account.
  3. Mint directly to the trade_account_id, or use SDK setup helpers.

The SDK quick starts call helpers that create the account, fund it, and whitelist it where supported.

Test Tokens

Testnet/devnet assets commonly use f-prefixed symbols such as fUSDC, fETH, and fFUEL.

When selecting a market, match the market's base and quote asset IDs to the assets your faucet call funded. Do not rely only on symbols.

Whitelisting

Some test environments require a trading account to be whitelisted before order placement succeeds.

If order creation fails unexpectedly during setup, confirm the account has been whitelisted for the target environment.

Thin Order Books

Testnet and devnet order books may be thin, empty, or one-sided.

Before placing market-crossing orders:

  • check depth with GET /v1/depth
  • prefer conservative limit orders
  • expect fills to differ from realistic mainnet liquidity
  1. Create or load an owner wallet.
  2. Create a trading account.
  3. Fund the owner or trading account through the faucet.
  4. Fetch markets and select a funded pair.
  5. Create a session scoped to that market.
  6. Place a small limit order away from the spread.
  7. Query open orders.
  8. Cancel the order.
  9. Check balances and nonce state.

For language-specific examples, start with the TypeScript, Python, or Rust quick start.