Skip to main content
POST
/
v1
/
transaction_bundler
/
execute
Python (SDK)
from compass_api_sdk import CompassAPI, models


with CompassAPI(
    api_key_auth="<YOUR_API_KEY_HERE>",
) as compass_api:

    res = compass_api.transaction_bundler.transaction_bundler_execute(chain=models.MulticallExecuteRequestChain.ARBITRUM, sender="0x29F20a192328eF1aD35e1564aBFf4Be9C5ce5f7B", actions=[
        models.UserOperation(
            body=models.SetAllowanceParams(
                token="WETH",
                contract=models.SetAllowanceParamsContractEnum.UNISWAP_V3_ROUTER,
                amount="1000",
            ),
        ),
        models.UserOperation(
            body=models.UniswapBuyExactlyParams(
                token_in="WETH",
                token_out="USDC",
                fee=models.FeeEnum.ZERO_DOT_01,
                amount_out="1000",
                max_slippage_percent=0.5,
            ),
        ),
        models.UserOperation(
            body=models.SetAllowanceParams(
                token="USDC",
                contract=models.SetAllowanceParamsContractEnum.AAVE_V3_POOL,
                amount="1000",
            ),
        ),
        models.UserOperation(
            body=models.SetAllowanceParams(
                token="WETH",
                contract=models.SetAllowanceParamsContractEnum.AAVE_V3_POOL,
                amount="0.1",
            ),
        ),
        models.UserOperation(
            body=models.AaveSupplyParams(
                token="USDC",
                amount="1000",
            ),
        ),
        models.UserOperation(
            body=models.AaveBorrowParams(
                token="WETH",
                amount="0.1",
                interest_rate_mode=models.InterestRateMode.VARIABLE,
            ),
        ),
    ], estimate_gas=True, signed_authorization={
        "nonce": 1000,
        "address": "0xcA11bde05977b3631167028862bE2a173976CA11",
        "chain_id": 42161,
        "r": "0x5f9f3f3226ac91bc01a72dd117141f6c6de1ed30d3af9f95c3423316dc21d615",
        "s": "0x78f7982ede9dabc53d7153974c5692fda8a21fc73bdafc42aaf135505e22817c",
        "y_parity": 0,
    })

    # Handle response
    print(res)
import { CompassApiSDK } from "@compass-labs/api-sdk";

const compassApiSDK = new CompassApiSDK({
  apiKeyAuth: "<YOUR_API_KEY_HERE>",
});

async function run() {
  const result = await compassApiSDK.transactionBundler.transactionBundlerExecute({
    chain: "arbitrum",
    sender: "0x29F20a192328eF1aD35e1564aBFf4Be9C5ce5f7B",
    estimateGas: true,
    signedAuthorization: {
      nonce: 1000,
      address: "0xcA11bde05977b3631167028862bE2a173976CA11",
      chainId: 42161,
      r: "0x5f9f3f3226ac91bc01a72dd117141f6c6de1ed30d3af9f95c3423316dc21d615",
      s: "0x78f7982ede9dabc53d7153974c5692fda8a21fc73bdafc42aaf135505e22817c",
      yParity: 0,
    },
    actions: [
      {
        body: {
          actionType: "SET_ALLOWANCE",
          token: "WETH",
          contract: "UniswapV3Router",
          amount: "1000",
        },
      },
      {
        body: {
          actionType: "UNISWAP_BUY_EXACTLY",
          tokenIn: "WETH",
          tokenOut: "USDC",
          fee: "0.01",
          amountOut: "1000",
          maxSlippagePercent: 0.5,
        },
      },
      {
        body: {
          actionType: "SET_ALLOWANCE",
          token: "USDC",
          contract: "AaveV3Pool",
          amount: "1000",
        },
      },
      {
        body: {
          actionType: "SET_ALLOWANCE",
          token: "WETH",
          contract: "AaveV3Pool",
          amount: "0.1",
        },
      },
      {
        body: {
          actionType: "AAVE_SUPPLY",
          token: "USDC",
          amount: "1000",
        },
      },
      {
        body: {
          actionType: "AAVE_BORROW",
          token: "WETH",
          amount: "0.1",
          interestRateMode: "variable",
        },
      },
    ],
  });

  console.log(result);
}

run();
curl --request POST \
  --url https://api.compasslabs.ai/v1/transaction_bundler/execute \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "chain": "arbitrum",
  "sender": "0x29F20a192328eF1aD35e1564aBFf4Be9C5ce5f7B",
  "estimate_gas": true,
  "signed_authorization": {
    "address": "0xcA11bde05977b3631167028862bE2a173976CA11",
    "chainId": 42161,
    "nonce": 1000,
    "r": "0x5f9f3f3226ac91bc01a72dd117141f6c6de1ed30d3af9f95c3423316dc21d615",
    "s": "0x78f7982ede9dabc53d7153974c5692fda8a21fc73bdafc42aaf135505e22817c",
    "yParity": 0
  },
  "actions": [
    {
      "body": {
        "action_type": "SET_ALLOWANCE",
        "amount": "1000",
        "contract": "UniswapV3Router",
        "token": "WETH"
      }
    },
    {
      "body": {
        "action_type": "UNISWAP_BUY_EXACTLY",
        "amount_out": "1000",
        "fee": "0.01",
        "max_slippage_percent": 0.5,
        "token_in": "WETH",
        "token_out": "USDC"
      }
    },
    {
      "body": {
        "action_type": "SET_ALLOWANCE",
        "amount": "1000",
        "contract": "AaveV3Pool",
        "token": "USDC"
      }
    },
    {
      "body": {
        "action_type": "SET_ALLOWANCE",
        "amount": "0.1",
        "contract": "AaveV3Pool",
        "token": "WETH"
      }
    },
    {
      "body": {
        "action_type": "AAVE_SUPPLY",
        "amount": "1000",
        "token": "USDC"
      }
    },
    {
      "body": {
        "action_type": "AAVE_BORROW",
        "amount": "0.1",
        "interest_rate_mode": "variable",
        "token": "WETH"
      }
    }
  ]
}
'
const options = {
  method: 'POST',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    chain: 'arbitrum',
    sender: '0x29F20a192328eF1aD35e1564aBFf4Be9C5ce5f7B',
    estimate_gas: true,
    signed_authorization: {
      address: '0xcA11bde05977b3631167028862bE2a173976CA11',
      chainId: 42161,
      nonce: 1000,
      r: '0x5f9f3f3226ac91bc01a72dd117141f6c6de1ed30d3af9f95c3423316dc21d615',
      s: '0x78f7982ede9dabc53d7153974c5692fda8a21fc73bdafc42aaf135505e22817c',
      yParity: 0
    },
    actions: [
      {
        body: JSON.stringify({
          action_type: 'SET_ALLOWANCE',
          amount: '1000',
          contract: 'UniswapV3Router',
          token: 'WETH'
        })
      },
      {
        body: JSON.stringify({
          action_type: 'UNISWAP_BUY_EXACTLY',
          amount_out: '1000',
          fee: '0.01',
          max_slippage_percent: 0.5,
          token_in: 'WETH',
          token_out: 'USDC'
        })
      },
      {
        body: JSON.stringify({
          action_type: 'SET_ALLOWANCE',
          amount: '1000',
          contract: 'AaveV3Pool',
          token: 'USDC'
        })
      },
      {
        body: JSON.stringify({
          action_type: 'SET_ALLOWANCE',
          amount: '0.1',
          contract: 'AaveV3Pool',
          token: 'WETH'
        })
      },
      {
        body: JSON.stringify({action_type: 'AAVE_SUPPLY', amount: '1000', token: 'USDC'})
      },
      {
        body: JSON.stringify({
          action_type: 'AAVE_BORROW',
          amount: '0.1',
          interest_rate_mode: 'variable',
          token: 'WETH'
        })
      }
    ]
  })
};

fetch('https://api.compasslabs.ai/v1/transaction_bundler/execute', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.compasslabs.ai/v1/transaction_bundler/execute",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'chain' => 'arbitrum',
    'sender' => '0x29F20a192328eF1aD35e1564aBFf4Be9C5ce5f7B',
    'estimate_gas' => true,
    'signed_authorization' => [
        'address' => '0xcA11bde05977b3631167028862bE2a173976CA11',
        'chainId' => 42161,
        'nonce' => 1000,
        'r' => '0x5f9f3f3226ac91bc01a72dd117141f6c6de1ed30d3af9f95c3423316dc21d615',
        's' => '0x78f7982ede9dabc53d7153974c5692fda8a21fc73bdafc42aaf135505e22817c',
        'yParity' => 0
    ],
    'actions' => [
        [
                'body' => [
                                'action_type' => 'SET_ALLOWANCE',
                                'amount' => '1000',
                                'contract' => 'UniswapV3Router',
                                'token' => 'WETH'
                ]
        ],
        [
                'body' => [
                                'action_type' => 'UNISWAP_BUY_EXACTLY',
                                'amount_out' => '1000',
                                'fee' => '0.01',
                                'max_slippage_percent' => 0.5,
                                'token_in' => 'WETH',
                                'token_out' => 'USDC'
                ]
        ],
        [
                'body' => [
                                'action_type' => 'SET_ALLOWANCE',
                                'amount' => '1000',
                                'contract' => 'AaveV3Pool',
                                'token' => 'USDC'
                ]
        ],
        [
                'body' => [
                                'action_type' => 'SET_ALLOWANCE',
                                'amount' => '0.1',
                                'contract' => 'AaveV3Pool',
                                'token' => 'WETH'
                ]
        ],
        [
                'body' => [
                                'action_type' => 'AAVE_SUPPLY',
                                'amount' => '1000',
                                'token' => 'USDC'
                ]
        ],
        [
                'body' => [
                                'action_type' => 'AAVE_BORROW',
                                'amount' => '0.1',
                                'interest_rate_mode' => 'variable',
                                'token' => 'WETH'
                ]
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.compasslabs.ai/v1/transaction_bundler/execute"

	payload := strings.NewReader("{\n  \"chain\": \"arbitrum\",\n  \"sender\": \"0x29F20a192328eF1aD35e1564aBFf4Be9C5ce5f7B\",\n  \"estimate_gas\": true,\n  \"signed_authorization\": {\n    \"address\": \"0xcA11bde05977b3631167028862bE2a173976CA11\",\n    \"chainId\": 42161,\n    \"nonce\": 1000,\n    \"r\": \"0x5f9f3f3226ac91bc01a72dd117141f6c6de1ed30d3af9f95c3423316dc21d615\",\n    \"s\": \"0x78f7982ede9dabc53d7153974c5692fda8a21fc73bdafc42aaf135505e22817c\",\n    \"yParity\": 0\n  },\n  \"actions\": [\n    {\n      \"body\": {\n        \"action_type\": \"SET_ALLOWANCE\",\n        \"amount\": \"1000\",\n        \"contract\": \"UniswapV3Router\",\n        \"token\": \"WETH\"\n      }\n    },\n    {\n      \"body\": {\n        \"action_type\": \"UNISWAP_BUY_EXACTLY\",\n        \"amount_out\": \"1000\",\n        \"fee\": \"0.01\",\n        \"max_slippage_percent\": 0.5,\n        \"token_in\": \"WETH\",\n        \"token_out\": \"USDC\"\n      }\n    },\n    {\n      \"body\": {\n        \"action_type\": \"SET_ALLOWANCE\",\n        \"amount\": \"1000\",\n        \"contract\": \"AaveV3Pool\",\n        \"token\": \"USDC\"\n      }\n    },\n    {\n      \"body\": {\n        \"action_type\": \"SET_ALLOWANCE\",\n        \"amount\": \"0.1\",\n        \"contract\": \"AaveV3Pool\",\n        \"token\": \"WETH\"\n      }\n    },\n    {\n      \"body\": {\n        \"action_type\": \"AAVE_SUPPLY\",\n        \"amount\": \"1000\",\n        \"token\": \"USDC\"\n      }\n    },\n    {\n      \"body\": {\n        \"action_type\": \"AAVE_BORROW\",\n        \"amount\": \"0.1\",\n        \"interest_rate_mode\": \"variable\",\n        \"token\": \"WETH\"\n      }\n    }\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-api-key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
HttpResponse<String> response = Unirest.post("https://api.compasslabs.ai/v1/transaction_bundler/execute")
  .header("x-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"chain\": \"arbitrum\",\n  \"sender\": \"0x29F20a192328eF1aD35e1564aBFf4Be9C5ce5f7B\",\n  \"estimate_gas\": true,\n  \"signed_authorization\": {\n    \"address\": \"0xcA11bde05977b3631167028862bE2a173976CA11\",\n    \"chainId\": 42161,\n    \"nonce\": 1000,\n    \"r\": \"0x5f9f3f3226ac91bc01a72dd117141f6c6de1ed30d3af9f95c3423316dc21d615\",\n    \"s\": \"0x78f7982ede9dabc53d7153974c5692fda8a21fc73bdafc42aaf135505e22817c\",\n    \"yParity\": 0\n  },\n  \"actions\": [\n    {\n      \"body\": {\n        \"action_type\": \"SET_ALLOWANCE\",\n        \"amount\": \"1000\",\n        \"contract\": \"UniswapV3Router\",\n        \"token\": \"WETH\"\n      }\n    },\n    {\n      \"body\": {\n        \"action_type\": \"UNISWAP_BUY_EXACTLY\",\n        \"amount_out\": \"1000\",\n        \"fee\": \"0.01\",\n        \"max_slippage_percent\": 0.5,\n        \"token_in\": \"WETH\",\n        \"token_out\": \"USDC\"\n      }\n    },\n    {\n      \"body\": {\n        \"action_type\": \"SET_ALLOWANCE\",\n        \"amount\": \"1000\",\n        \"contract\": \"AaveV3Pool\",\n        \"token\": \"USDC\"\n      }\n    },\n    {\n      \"body\": {\n        \"action_type\": \"SET_ALLOWANCE\",\n        \"amount\": \"0.1\",\n        \"contract\": \"AaveV3Pool\",\n        \"token\": \"WETH\"\n      }\n    },\n    {\n      \"body\": {\n        \"action_type\": \"AAVE_SUPPLY\",\n        \"amount\": \"1000\",\n        \"token\": \"USDC\"\n      }\n    },\n    {\n      \"body\": {\n        \"action_type\": \"AAVE_BORROW\",\n        \"amount\": \"0.1\",\n        \"interest_rate_mode\": \"variable\",\n        \"token\": \"WETH\"\n      }\n    }\n  ]\n}")
  .asString();
require 'uri'
require 'net/http'

url = URI("https://api.compasslabs.ai/v1/transaction_bundler/execute")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"chain\": \"arbitrum\",\n  \"sender\": \"0x29F20a192328eF1aD35e1564aBFf4Be9C5ce5f7B\",\n  \"estimate_gas\": true,\n  \"signed_authorization\": {\n    \"address\": \"0xcA11bde05977b3631167028862bE2a173976CA11\",\n    \"chainId\": 42161,\n    \"nonce\": 1000,\n    \"r\": \"0x5f9f3f3226ac91bc01a72dd117141f6c6de1ed30d3af9f95c3423316dc21d615\",\n    \"s\": \"0x78f7982ede9dabc53d7153974c5692fda8a21fc73bdafc42aaf135505e22817c\",\n    \"yParity\": 0\n  },\n  \"actions\": [\n    {\n      \"body\": {\n        \"action_type\": \"SET_ALLOWANCE\",\n        \"amount\": \"1000\",\n        \"contract\": \"UniswapV3Router\",\n        \"token\": \"WETH\"\n      }\n    },\n    {\n      \"body\": {\n        \"action_type\": \"UNISWAP_BUY_EXACTLY\",\n        \"amount_out\": \"1000\",\n        \"fee\": \"0.01\",\n        \"max_slippage_percent\": 0.5,\n        \"token_in\": \"WETH\",\n        \"token_out\": \"USDC\"\n      }\n    },\n    {\n      \"body\": {\n        \"action_type\": \"SET_ALLOWANCE\",\n        \"amount\": \"1000\",\n        \"contract\": \"AaveV3Pool\",\n        \"token\": \"USDC\"\n      }\n    },\n    {\n      \"body\": {\n        \"action_type\": \"SET_ALLOWANCE\",\n        \"amount\": \"0.1\",\n        \"contract\": \"AaveV3Pool\",\n        \"token\": \"WETH\"\n      }\n    },\n    {\n      \"body\": {\n        \"action_type\": \"AAVE_SUPPLY\",\n        \"amount\": \"1000\",\n        \"token\": \"USDC\"\n      }\n    },\n    {\n      \"body\": {\n        \"action_type\": \"AAVE_BORROW\",\n        \"amount\": \"0.1\",\n        \"interest_rate_mode\": \"variable\",\n        \"token\": \"WETH\"\n      }\n    }\n  ]\n}"

response = http.request(request)
puts response.read_body
{
  "transaction": {
    "chainId": "0x2105",
    "data": "0x1688f0b900000000000000000000000029fcb43b46531bca003ddc8fcb67ffe91900c762000000000000000000000000000000000000000000000000000000000000006000000000000000000000000000000000000000000000000000000000675f4a3d",
    "from": "0x4A83b4413CF41C3244027e1590E35a0F48403F0c",
    "gas": "0x7a120",
    "maxFeePerGas": "0x59682f00",
    "maxPriorityFeePerGas": "0x3b9aca00",
    "nonce": "0x5",
    "to": "0x4e1DCf7AD4e460CfD30791CCC4F9c8a4f820ec67",
    "value": "0x0"
  }
}
{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

Authorizations

​
x-api-key
string
header
required

Your Compass API Key. Get your key here.

Body

application/json

Request model for executing a multicall.

​
chain
enum<string>
default:arbitrum
required
Available options:
arbitrum,
base,
ethereum
Example:

"arbitrum"

​
sender
string
default:0x29F20a192328eF1aD35e1564aBFf4Be9C5ce5f7B
required

The address of the transaction sender.

Example:

"0x29F20a192328eF1aD35e1564aBFf4Be9C5ce5f7B"

​
actions
UserOperation · object[]
required

List of possible actions for multicall

Examples:
{
  "body": {
    "action_type": "SET_ALLOWANCE",
    "amount": "1000",
    "contract": "UniswapV3Router",
    "token": "WETH"
  }
}
{
  "body": {
    "action_type": "UNISWAP_BUY_EXACTLY",
    "amount_out": "1000",
    "fee": "0.01",
    "max_slippage_percent": 0.5,
    "token_in": "WETH",
    "token_out": "USDC"
  }
}
{
  "body": {
    "action_type": "SET_ALLOWANCE",
    "amount": "1000",
    "contract": "AaveV3Pool",
    "token": "USDC"
  }
}
{
  "body": {
    "action_type": "SET_ALLOWANCE",
    "amount": "0.1",
    "contract": "AaveV3Pool",
    "token": "WETH"
  }
}
{
  "body": {
    "action_type": "AAVE_SUPPLY",
    "amount": "1000",
    "token": "USDC"
  }
}
{
  "body": {
    "action_type": "AAVE_BORROW",
    "amount": "0.1",
    "interest_rate_mode": "variable",
    "token": "WETH"
  }
}
​
estimate_gas
boolean
default:true

Determines whether to estimate gas costs for transactions, also verifying that the transaction can be successfully executed.

Example:

true

​
signed_authorization
SignedAuthorization · object | null

EIP-7702 authorization

Example:
{
  "address": "0xcA11bde05977b3631167028862bE2a173976CA11",
  "chainId": 42161,
  "nonce": 1000,
  "r": "0x5f9f3f3226ac91bc01a72dd117141f6c6de1ed30d3af9f95c3423316dc21d615",
  "s": "0x78f7982ede9dabc53d7153974c5692fda8a21fc73bdafc42aaf135505e22817c",
  "yParity": 0
}

Response

Successful Response

​
transaction
UnsignedMulticallTransaction · object
required

The unsigned multicall transaction data. User must sign and broadcast to network.

Example:
{
  "chainId": "0x2105",
  "data": "0x1688f0b900000000000000000000000029fcb43b46531bca003ddc8fcb67ffe91900c762000000000000000000000000000000000000000000000000000000000000006000000000000000000000000000000000000000000000000000000000675f4a3d",
  "from": "0x4A83b4413CF41C3244027e1590E35a0F48403F0c",
  "gas": "0x7a120",
  "maxFeePerGas": "0x59682f00",
  "maxPriorityFeePerGas": "0x3b9aca00",
  "nonce": "0x5",
  "to": "0x4e1DCf7AD4e460CfD30791CCC4F9c8a4f820ec67",
  "value": "0x0"
}