Skip to main content

Arbitrum Swap API

Broker as a Service (BaaS) swaps ETH and the listed tokens on Arbitrum to and from every other supported chain, through the REST API and the MCP server. This page collects what is specific to Arbitrum: minimums and token contracts, addresses, deposits and refunds, vault swaps and pitfalls. For the general flow, start with Starting a Swap and View Available Assets.

Assets and minimums​

AssetidDecimalsMinimumNative minimumContract
ETHeth.arb180.0039 ETH3900000000000000—
USDCusdc.arb610 USDC100000000xaf88d065e77c8cC2239327C5EDb3A432268e5831
USDTusdt.arb610 USDT100000000xFd086bC7CD5C481DCC9C85ebE478A1C0b69FCbb9

Snapshot captured on 2026-11-17 from the production /assets endpoint. Minimums are Chainflip's current source (ingress) minimum deposit amounts; query /assets for live values. Destination-side egress minimums depend on gas and are not in /assets; see Error Codes for egress_below_minimum and egress_fee_not_covered. minimalAmountNative is in the asset's smallest unit. Assets disabled upstream are omitted.

The Contract column is the token's Arbitrum contract, which differs from the same token's Ethereum contract. ETH on Arbitrum is eth.arb, not eth.eth: both have the ticker ETH, so always pass the id.

Addresses​

Arbitrum uses Ethereum's address format: 0x followed by 40 hexadecimal characters. A mixed-case address must carry a valid EIP-55 checksum; an all-lowercase or all-uppercase address is accepted without one. The same rules apply on Ethereum and BNB Smart Chain, so BaaS cannot tell which EVM chain an address was meant for: confirm the user controls it on Arbitrum.

A destination address is checked with the destination asset's rules and a refund address with the source asset's, so an Arbitrum refundAddress is required when the source asset is on Arbitrum.

Deposits and refunds​

A /swap call opens a deposit channel and returns the address the user sends the source asset to.

  • Deposit channels close after 24 hours. Open a new channel for every deposit-channel swap and send the deposit immediately (Chainflip: closure of deposit channels).
  • minimumPrice and refundAddress are required.
  • retryDurationInBlocks is optional: omitted or negative, it is the 150-block (15-minute) default, and a value above Chainflip's current runtime limit is lowered to that limit. Use the quote's recommendedRetryDurationInBlocks.
  • If the minimum price or live price protection is not met within the retry window, the source asset is refunded to refundAddress. For DCA, only unexecuted chunks are refunded; executed chunks still pay out to the destination.

See Starting a Swap and Chainflip's Swapping Basics.

Chainflip's ingress table lists a safety margin of 49 to 72 Arbitrum blocks, about 13 to 19 seconds. Show users the quote's estimatedDurationSeconds rather than a fixed number.

Vault swaps​

An Arbitrum vault swap is a call to Chainflip's Vault contract on Arbitrum that your application or the user's wallet signs and submits; there is no deposit channel. /tx-payload/evm serves Arbitrum as well as Ethereum. It takes sourceAmount (in the source asset's smallest unit), minimumPrice, refundAddress and retryDurationInBlocks, and returns:

  • to - the Vault contract to call.
  • callData - the encoded swap call.
  • value - the amount of native arbETH to attach, hex-encoded.
  • sourceTokenAddress - only for a token source: the token to approve. It is a response field, not a request parameter.

For a token source, the Vault must be approved to spend the token before the swap transaction is submitted; without the approval the call fails on chain. For an ETH source (eth.arb), the swap amount travels as the transaction's value in arbETH.

Payloads can stay valid for a long time, but Chainflip advises signing and broadcasting only freshly built ones. See Chainflip's EVM Vault Swaps for the protocol details.

Boost is documented for Bitcoin deposits; see the Bitcoin page.

Known pitfalls​

  • Layer-2 safety margin. Arbitrum deposits wait for dozens of Arbitrum blocks, which still takes only seconds; do not compare block counts across chains.
  • Wrong ETH. eth.arb and eth.eth share the ticker; a swap from the wrong one expects the deposit on the other chain.
  • Token approval. A token vault swap needs an approval transaction first.
  • Gas and egress fees. A small output can be rejected at quote time with egress_below_minimum or egress_fee_not_covered; quote a bigger amount.
  • Payload freshness. Build a new vault payload for each transaction instead of reusing an old one.
  • Same address, other chains. An Arbitrum address is also valid on Ethereum and BNB Smart Chain; check which chain the user expects.