Skip to main content

Solana Swap API

Broker as a Service (BaaS) swaps SOL and the listed SPL tokens on Solana to and from every other supported chain, through the REST API and the MCP server. This page collects what is specific to Solana: minimums and token mints, 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
SOLsol.sol90.068 SOL68000000—
USDCusdc.sol610 USDC10000000EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
USDTusdt.sol610 USDT10000000Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB

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 fees 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 (lamports for SOL). Assets disabled upstream are omitted.

The Contract column is the token's mint address.

Addresses​

BaaS accepts a Solana address in base58 that decodes to exactly 32 bytes. The 64-character hex form that Chainflip's broker API also accepts is rejected by BaaS, so always pass base58.

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

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 waits for the finalized commitment on Solana, about 12 seconds. Show users the quote's estimatedDurationSeconds rather than a fixed number.

Vault swaps​

A Solana vault swap is a call to Chainflip's Swap Endpoint program that your application or the user's wallet signs and submits; there is no deposit channel. /tx-payload/solana returns the programId, accounts and data of the instruction. Besides sourceAmount, minimumPrice, refundAddress and retryDurationInBlocks, it requires:

  • sourceAddress - the account that signs and pays for the swap.
  • eventDataAccount - the address of the event data account, already derived. BaaS takes the account itself and has no seed parameter; the seed Chainflip's protocol documentation describes is only how you derive it.
  • sourceTokenAccount - optional, for an SPL token source: the token account of sourceAddress the tokens are sent from, normally its associated token account (ATA).

The Swap Endpoint program creates the event data account in the submitted transaction, and the user pays its rent. Once the swap is processed, Chainflip closes the account and returns the rent. BaaS does not create the associated token account: it must already exist and hold the tokens.

See Chainflip's Solana Vault Swaps for the protocol details.

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

Known pitfalls​

  • Unvalidated accounts. BaaS checks only the destination and refund addresses of a vault swap. A wrong sourceAddress, eventDataAccount or sourceTokenAccount is passed on as given and fails later, at the broker or on chain.
  • Rent. The sender needs enough SOL for the event data account's rent on top of the swap and the transaction fee; the rent comes back after the swap.
  • Token account. For an SPL token source the token account must exist; BaaS does not create it.
  • Base58 only. Hex-encoded Solana addresses are rejected.
  • Finalized deposits. Deposits count only once finalized, so allow the quote's duration before treating a swap as stuck.