v1

latestOpenAPI 3.1.02026-07-24223580832.9 KB

bridge

Create Bridge Swap Transaction with Approval

Generates both token approval and swap transactions in a single call with configurable slippage protection.

💡 Compute Unit Value: 110 (Fixed)

post/defi/v1/bridge/swap-with-approval

Request body

bridgeId'600' | '300' | '400' | '100' | '500'

The unique ID to specify the bridge protocol for routing cross-chain queries or transactions. Find more here.

srcChainIdstring

The unique chain ID to specify the source chain. Find more here.

dstChainIdstring required

The unique chain ID to specify the destination chain. Find more here.

srcTokenSymbolstring

Symbol of the token to swap.

dstTokenSymbolstring

Symbol of the token to be received after the swap.

srcTokenAddressstring

Address of the source token.

dstTokenAddressstring

Address of the destination token.

amountInstring required

Amount of the token to be swapped.

amountOutMinstring

Minimum amount accepted as the result of the swap.

fromstring required

Address of the token sender.

tostring required

Address of the token recipient.

gasPrioritystring

Specifies the priority level for gas fees (e.g., 'low', 'medium', or 'high'), which influences the transaction speed and cost.

slippagestring

Percentage of the total swap value. Defaults to 1. Valid range: 0 <= slippage <= 100.

enableFeeboolean

Flag to include a basis points fee transaction alongside the main transaction when set to true.

batchOption'EIP-5792' | 'EIP-7702'

The batch option to be used for the transaction.

batcherContractstring

The EOA address of the batcher that will be used to execute the transaction when using EIP-7702 batching. If not provided, the default batcher contract for the chain will be used.

gasstring

Maximum gas to be approved for the transaction.

srcChainSymbolstring

Symbol of the source chain.

Example request

{
  "bridgeId": "600",
  "srcChainId": "1",
  "dstChainId": "1",
  "srcTokenSymbol": "usdt",
  "dstTokenSymbol": "ETH",
  "srcTokenAddress": "0xdAe2F6EdDdA6fb4fb60cc02633DE27e2b431B402",
  "dstTokenAddress": "0xdAe2F6EdDdA6fb4fb60cc02633DE27e2b431B402",
  "amountIn": "10000",
  "amountOutMin": "0",
  "from": "0xdAe2F6EdDdA6fb4fb60cc02633DE27e2b431B402",
  "to": "0xdAe2F6EdDdA6fb4fb60cc02633DE27e2b431B402",
  "gasPriority": "low",
  "slippage": "10",
  "enableFee": false,
  "batchOption": "EIP-5792",
  "batcherContract": "0x9c933f9d2efd76ce25b0d3dde84d3f94e78a50ca",
  "gas": "100000",
  "srcChainSymbol": "ETH"
}

Response

Successful response

statusnumber

Numeric status code indicating success or failure of the API call

msgstring

Human-readable message describing the API result or error

Example response

{
  "status": 200,
  "msg": "success",
  "data": [
    {
      "chainId": "1",
      "from": "0xa67E9B68c41b0f26184D64C26e0b2B81466E5994",
      "to": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
      "value": "0",
      "gas": "900000",
      "data": "0x095ea7b30000000000000000000000008731d54e9d02c286767d56ac03e8037c07e01e980000000000000000000000000000000000000000000000000000000000002710",
      "nonce": 0,
      "referenceId": "fdd8054bbd7f42d59692b35e7e7141c0"
    },
    {
      "chainId": "1",
      "from": "0xa67E9B68c41b0f26184D64C26e0b2B81466E5994",
      "to": "0x8731d54E9D02c286767d56ac03e8037C07e01e98",
      "value": "336014619161195",
      "gas": "900000",
      "data": "0x9fbf10fc000000000000000000000000000000000000000000000000000000000000006d00000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000000001000000000000000000000000a67e9b68c41b0f26184d64c26e0b2b81466e599400000000000000000000000000000000000000000000000000000000000027100000000000000000000000000000000000000000000000000000000000000064000000000000000000000000000000000000000000000000000000000000012000000000000000000000000000000000000000000000000000000000000001a000000000000000000000000000000000000000000000000000000000000001e000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000006000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000014a67e9b68c41b0f26184d64c26e0b2b81466e59940000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
      "gasPrice": "1588879231",
      "nonce": 1,
      "referenceId": "fdd8054bbd7f42d59692b35e7e7141c0"
    }
  ]
}