Uniswap V3

Buy exact amount

This endpoint allows users to trade a variable amount of one token to receive an exact amount of another token using the Uniswap protocol.

The transaction is executed on the specified blockchain network, and the user must provide the necessary transaction details, including the token to buy, the token to pay with, and the exact amount to receive. If the token being paid with is WETH and needs to be wrapped, the appropriate amount will be wrapped automatically.

POST

uniswap

swap

buy_exactly

from compassapisdk import CompassAPISDK, models


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

    res = compass_api_sdk.uniswap_v3.swap_buy_exactly(token_in=models.TokenEnum.SNX, token_out=models.TokenEnum.CB_ETH, fee=models.FeeEnum.ONE_DOT_0, amount_out=1.5, amount_in_maximum=1.6, chain=models.Chain.ETHEREUM_MAINNET, sender="0x29F20a192328eF1aD35e1564aBFf4Be9C5ce5f7B")

    # Handle response
    print(res)

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

Authorizations

x-api-key

string

header

required

Your Compass API Key. Get your key here.

Body

application/json

Request model for buying exactly an amount of tokens.

token_in

enum<string>

required

The symbol of the token to swap from.

Available options:

1INCH,

AAVE,

BAL,

cbBTC,

cbETH,

CRV,

crvUSD,

DAI,

ENS,

ETHx,

FRAX,

FXS,

GHO,

KNC,

LDO,

LINK,

LUSD,

MKR,

osETH,

PYUSD,

rETH,

RPL,

rsETH,

sDAI,

SNX,

STG,

sUSDe,

tBTC,

UNI,

USDC,

USDe,

USDS,

USDT,

WBTC,

weETH,

WETH,

wstETH,

ARB,

EURS,

MAI,

USDCe,

AERO,

EUR,

VIRTUAL

token_out

enum<string>

required

The symbol of the token to swap to.

Available options:

1INCH,

AAVE,

BAL,

cbBTC,

cbETH,

CRV,

crvUSD,

DAI,

ENS,

ETHx,

FRAX,

FXS,

GHO,

KNC,

LDO,

LINK,

LUSD,

MKR,

osETH,

PYUSD,

rETH,

RPL,

rsETH,

sDAI,

SNX,

STG,

sUSDe,

tBTC,

UNI,

USDC,

USDe,

USDS,

USDT,

WBTC,

weETH,

WETH,

wstETH,

ARB,

EURS,

MAI,

USDCe,

AERO,

EUR,

VIRTUAL

fee

enum<string>

required

The swap fee of the pool

Available options:

0.01,

0.05,

0.3,

1.0

amount_out

required

The amount of the token to swap to

Required range: x > 0

Examples:

1.5

amount_in_maximum

required

The maximum amount of the token to swap from

Required range: x >= 0

Examples:

1.6

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"

wrap_eth

boolean

default:false

Whether to wrap ETH to WETH, only use when swapping WETH into something

Examples:

true

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

List LP Sell exact amount

from compassapisdk import CompassAPISDK, models


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

    res = compass_api_sdk.uniswap_v3.swap_buy_exactly(token_in=models.TokenEnum.SNX, token_out=models.TokenEnum.CB_ETH, fee=models.FeeEnum.ONE_DOT_0, amount_out=1.5, amount_in_maximum=1.6, chain=models.Chain.ETHEREUM_MAINNET, sender="0x29F20a192328eF1aD35e1564aBFf4Be9C5ce5f7B")

    # Handle response
    print(res)

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

Aave V3

Aerodrome Slipstream

Morpho

Token

Uniswap V3

Universal

Transaction Batching

Buy exact amount

Authorizations

Body

Response