Execute Tx Batching

POST

multicall

execute

from compassapisdk import CompassAPISDK, models


with CompassAPISDK(
    api_key_auth="<YOUR_API_KEY_HERE>",
) as compass_api_sdk:

    res = compass_api_sdk.transaction_batching.execute(chain=models.Chain.BASE_MAINNET, sender="0x29F20a192328eF1aD35e1564aBFf4Be9C5ce5f7B", signed_authorization={
        "nonce": 1000,
        "address": "0xcA11bde05977b3631167028862bE2a173976CA11",
        "chain_id": 42161,
        "r": 4.3251085460800106e+76,
        "s": 5.471500338403868e+76,
        "y_parity": 0,
    }, actions=[
        models.MulticallAction(
            action_type=models.MulticallActionType.UNISWAP_BUY_EXACTLY,
            body=models.UniswapBuyExactlyParams(
                token_in=models.TokenEnum.WETH,
                token_out=models.TokenEnum.USDC,
                fee=models.FeeEnum.ZERO_DOT_01,
                amount_out=1.5,
                amount_in_maximum=1.6,
                wrap_eth=True,
            ),
        ),
    ])

    # Handle response
    print(res)

{
  "chainId": 123,
  "data": "<string>",
  "from": "<string>",
  "gas": 123,
  "to": "<string>",
  "value": 123,
  "nonce": 123,
  "maxFeePerGas": 123,
  "maxPriorityFeePerGas": 123,
  "authorizationList": []
}

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>

required

The chain to use.

Available options:

base:mainnet,

ethereum:mainnet,

arbitrum:mainnet

sender

string

required

The address of the transaction sender.

Examples:

"0x29F20a192328eF1aD35e1564aBFf4Be9C5ce5f7B"

signed_authorization

object

required

EIP-7702 authorization

actions

object[]

required

List of possible actions for multicall

actions.action_type

enum<string>

required

Available options:

ALLOWANCE_INCREASE_ANY,

TRANSFER_ERC20,

UNISWAP_MINT_LIQUIDITY,

AAVE_BORROW,

AERODROME_BASIC_REMOVE_LIQUIDITY,

AERODROME_SLIPSTREAM_WITHDRAW_LIQUIDITY,

UNISWAP_WITHDRAW_LIQUIDITY,

UNISWAP_BUY_EXACTLY,

AERODROME_SLIPSTREAM_BUY_EXACTLY,

AAVE_SUPPLY,

AERODROME_BASIC_ADD_LIQUIDITY,

AAVE_REPAY,

UNWRAP_WETH,

UNISWAP_SELL_EXACTLY,

AERODROME_BASIC_REMOVE_LIQUIDITY_ETH,

UNISWAP_ADD_LIQUIDITY,

AERODROME_BASIC_SWAP_TOKEN,

AAVE_WITHDRAW,

AERODROME_BASIC_ADD_LIQUIDITY_ETH,

AERODROME_SLIPSTREAM_SELL_EXACTLY,

AERODROME_BASIC_SWAP_TOKEN_FOR_ETH,

ALLOWANCE_INCREASE,

AERODROME_BASIC_SWAP_ETH_FOR_TOKEN,

AERODROME_SLIPSTREAM_INCREASE_LIQUIDITY,

WRAP_ETH,

AERODROME_SLIPSTREAM_MINT_LIQUIDITY

actions.body

object

required

Examples:

{
  "action_type": "ALLOWANCE_INCREASE",
  "body": {
    "amount": "1000",
    "contract_name": "UniswapV3Router",
    "token": "WETH"
  }
}

{
  "action_type": "UNISWAP_BUY_EXACTLY",
  "body": {
    "amount_in_maximum": "1",
    "amount_out": "1000",
    "fee": "0.01",
    "token_in": "WETH",
    "token_out": "USDC",
    "wrap_eth": true
  }
}

{
  "action_type": "ALLOWANCE_INCREASE",
  "body": {
    "amount": "1000",
    "contract_name": "AaveV3Pool",
    "token": "USDC"
  }
}

{
  "action_type": "ALLOWANCE_INCREASE",
  "body": {
    "amount": "0.1",
    "contract_name": "AaveV3Pool",
    "token": "WETH"
  }
}

{
  "action_type": "AAVE_SUPPLY",
  "body": { "amount": "1000", "token": "USDC" }
}

{
  "action_type": "AAVE_BORROW",
  "body": {
    "amount": "0.1",
    "interest_rate_mode": "variable",
    "token": "WETH"
  }
}

Response

200

application/json

Successful Response

chainId

integer

required

The chain id of the transaction

data

string

required

The data of the transaction

from

string

required

The sender of the transaction

gas

integer

required

The gas of the transaction

string

required

The recipient of the transaction

value

integer

required

The value of the transaction

nonce

integer

required

The nonce of the address

maxFeePerGas

integer

required

The max fee per gas of the transaction

maxPriorityFeePerGas

integer

required

The max priority fee per gas of the transaction

authorizationList

object[]

EIP-7702 authorization

Get EIP-7702 Authorization

from compassapisdk import CompassAPISDK, models


with CompassAPISDK(
    api_key_auth="<YOUR_API_KEY_HERE>",
) as compass_api_sdk:

    res = compass_api_sdk.transaction_batching.execute(chain=models.Chain.BASE_MAINNET, sender="0x29F20a192328eF1aD35e1564aBFf4Be9C5ce5f7B", signed_authorization={
        "nonce": 1000,
        "address": "0xcA11bde05977b3631167028862bE2a173976CA11",
        "chain_id": 42161,
        "r": 4.3251085460800106e+76,
        "s": 5.471500338403868e+76,
        "y_parity": 0,
    }, actions=[
        models.MulticallAction(
            action_type=models.MulticallActionType.UNISWAP_BUY_EXACTLY,
            body=models.UniswapBuyExactlyParams(
                token_in=models.TokenEnum.WETH,
                token_out=models.TokenEnum.USDC,
                fee=models.FeeEnum.ZERO_DOT_01,
                amount_out=1.5,
                amount_in_maximum=1.6,
                wrap_eth=True,
            ),
        ),
    ])

    # Handle response
    print(res)

{
  "chainId": 123,
  "data": "<string>",
  "from": "<string>",
  "gas": 123,
  "to": "<string>",
  "value": 123,
  "nonce": 123,
  "maxFeePerGas": 123,
  "maxPriorityFeePerGas": 123,
  "authorizationList": []
}

Aave V3

Aerodrome Slipstream

Morpho

Token

Uniswap V3

Universal

Transaction Batching

Authorizations

Body

Response