POST
/
v1
/
instructions
/
intent-simple
Build simple intents
curl --request POST \
  --url https://api.biconomy.io/v1/instructions/intent-simple \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '{
  "srcToken": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
  "dstToken": "0x94b008aa00579c1307b0ef2c499ad98a8ce58e58",
  "srcChainId": 8453,
  "dstChainId": 10,
  "ownerAddress": "0x742d35cc6639cb8d4b5d1c5d7b8b5e2e7c0c7a8a",
  "amount": "<any>",
  "mode": "smart-account",
  "allowSwapProviders": "lifi,gluex",
  "denySwapProviders": "",
  "allowBridgeProviders": "across",
  "denyBridgeProviders": "across",
  "slippage": 0.01
}'
{
  "instructions": [
    {
      "calls": [
        {
          "to": "0x1111111254EEB25477B68fb85Ed929f73A960582",
          "value": "0",
          "functionSig": "transfer(address,uint256)",
          "inputParams": [
            {
              "fetcherType": 0,
              "paramData": "0x742d35C9a91B1D5b5D24Dc30e8F0dF8E84b5d1c4",
              "constraints": []
            }
          ],
          "outputParams": [
            {
              "fetcherType": 0,
              "paramData": "0x"
            }
          ]
        }
      ],
      "chainId": 1,
      "isComposable": true
    }
  ],
  "outputAmount": "999960",
  "minOutputAmount": "989960",
  "route": {
    "summary": "lifi[sushiswap] => across[SpokePoolV3]",
    "steps": [
      {
        "type": "swap",
        "protocol": "lifi",
        "sources": [
          "sushiswap"
        ],
        "srcToken": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
        "dstToken": "0x94b008aa00579c1307b0ef2c499ad98a8ce58e58",
        "srcChainId": 8453,
        "dstChainId": 10,
        "inputAmount": "<any>",
        "outputAmount": "999960",
        "minOutputAmount": "989960",
        "toContract": "0x1231DEB6f5749EF6cE6943a275A1D3E7486F4EaE",
        "callData": "0x....",
        "isFirstStep": true,
        "pivotBalance": "999960"
      }
    ],
    "totalGasFeesUsd": 0,
    "totalBridgeFeesUsd": 0,
    "estimatedTime": 0,
    "outputAmount": "999960",
    "minOutputAmount": "989960",
    "type": "PIVOT_USDT"
  }
}

Authorizations

​
X-API-Key
string
header
required

API Key required to access Supertransaction API. Example: mee_2w3mXCuyt4xVXDRCZ5k5Lhgs

Body

application/json

Body

Object containing the cross-chain swap request fields, including source/destination tokens and chains, user address, amount, execution mode, provider allow/deny lists, and slippage tolerance.

​
srcToken
string
required

Source token EVM address. Must be a valid checksummed Ethereum address.

Example:

"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913"

​
dstToken
string
required

Destination token EVM address. Must be a valid checksummed Ethereum address.

Example:

"0x94b008aa00579c1307b0ef2c499ad98a8ce58e58"

​
srcChainId
number
required

The source chain ID for the swap. Use a supported chain ID number.

Example:

8453

​
dstChainId
number
required

The destination chain ID for the swap. Use a supported chain ID number.

Example:

10

​
ownerAddress
string
required

EOA wallet address which is going to be used as a owner of orchestrator account

Example:

"0x742d35cc6639cb8d4b5d1c5d7b8b5e2e7c0c7a8a"

​
amount
any
required
​
mode
enum<string>
required
Available options:
smart-account,
eoa,
eoa-7702
​
slippage
number
default:0.01
required

Slippage tolerance (0-1, default: 0.01 = 1%)

Required range: 0 <= x <= 1
Example:

0.01

​
allowSwapProviders
string

Comma-separated list of allowed swap providers.

Example:

"lifi,gluex"

​
denySwapProviders
string

Comma-separated list of denied swap providers.

Example:

""

​
allowBridgeProviders
string

Comma-separated list of allowed bridge providers.

Example:

"across"

​
denyBridgeProviders
string

Comma-separated list of denied bridge providers.

Example:

"across"

Response

Response schema for a cross-chain swap operation, including the generated MEE instructions, output amounts, and a detailed route summary. This object is returned after a successful swap request and provides all necessary data for execution and user feedback.

​
instructions
object[]
required
​
outputAmount
string
required

Output token amount (as string, in wei).

Example:

"999960"

​
minOutputAmount
string
required

Minimum output token amount (as string/bigint, in wei).

Example:

"989960"

​
route
object
required

Object describing a full cross-chain swap or bridge route, including a summary, steps, estimated fees, time, output amounts, and route type.