v2

latestOpenAPI 3.1.02026-07-316132736.5 KB

V2 - Swap

Send a swap transaction

Submit a signed swap transaction to the blockchain

post/api/2/swap/send

Request body

chainIdstring required

Chain dispatcher. Solana: solana:solana. EVM: evm:<chainId> (e.g. evm:8453 for Base). TON: ton:mainnet or ton:testnet.

signedTransactionstring

Base64 of the signed payload. Solana: signed VersionedTransaction/Transaction bytes. EVM: raw signed RLP. TON: signed external_in_message BoC.

awaitLandingboolean

When true, the endpoint blocks until on-chain confirmation and returns swap data.

feeWalletstring

Wallet that receives the referral fee on this swap. Echo from the original /quote request.

feeAmountUsdnumber nullable

Referral fee amount in USD for this swap (feePercentage × amountInUsd from the /quote response). Persisted for dashboard attribution; not re-validated against the signed transaction.

Example request

{
  "chainId": "solana:solana",
  "signedTransaction": "AQABAuObQ8Adqk1eqZxRMJg4r6vGtXq9k0...base64...",
  "candidates": [
    {
      "lander": "jito",
      "signedTransaction": "AQABAuObQ8Adqk1eqZxRMJg4r6vGtXq9k0...base64..."
    }
  ],
  "feeAmountUsd": 1.25
}

Response

Swap send response

errorstring