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)
{
  "transaction": {
    "chainId": "0x2105",
    "data": "0x1688f0b900000000000000000000000029fcb43b46531bca003ddc8fcb67ffe91900c762000000000000000000000000000000000000000000000000000000000000006000000000000000000000000000000000000000000000000000000000675f4a3d",
    "from": "0x4A83b4413CF41C3244027e1590E35a0F48403F0c",
    "gas": "0x7a120",
    "maxFeePerGas": "0x59682f00",
    "maxPriorityFeePerGas": "0x3b9aca00",
    "nonce": "0x5",
    "to": "0x4e1DCf7AD4e460CfD30791CCC4F9c8a4f820ec67",
    "value": "0x0"
  }
}

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
​
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.

​
signed_authorization
SignedAuthorization · object

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"
}