Aerodrome

Supported Chains

Available on Base

Available Endpoints:

Click on the endpoint to jump to the section with full details

  • /getprice GET - Returns the swap quotation for a given token pair on Aerodrome.

  • /getuserliquidity GET - Returns the balance of a particular token pair of accounts.

  • /getpoolliquidity GET - Returns the total liquidity for a specified pool.

  • /gettokenliquidity GET - Returns the individual token liquidity within the specified liquidity pool.

  • etpoolGET - Returns poolAddress, tickSpacing, tokensLiquidity and liquidity data based on tokenA and tokenB

  • /swap POST - Initiate a swap transaction on a specified DEX.

  • /addliquidity POST - Add liquidity to a specified pool in a specified DEX.

  • /removeliquidity POST - Remove liquidity from a specified pool in a specified DEX.

DEX IDs

Many endpoints have a parameter where you can provide a DEX ID.

Below is a list of DEX IDs related to PancakeSwap V3. Please see the DEX ID page for a complete DEX ID list and more information.

DEX Name
Chain
DEX ID

Aerodrome

Base

3600

Endpoint Details

/getprice

Returns the swap quotation for a given token pair on Aerodrome

GET https://api.expand.network/dex/getprice

Query Parameters

Name
Type
Description

rpc

String

Remote procedural call URL.

dexId*

String

See the DEX ID page for a list of all DEX IDs.

path*

String

Comma separated values of token addresses whose price is to be fetched.

amountIn*

String

Amount of token.

tickSpacing

String

Different pool based on the tick spacing. By default, it is selected as 100.

https://api.expand.network/dex/getprice?path=0x4200000000000000000000000000000000000006%2C0xacfE6019Ed1A7Dc6f7B508C02d1b04ec88cC21bf&tickSpacing=100&amountIn=10000000000000&dexId=3600

back to top

/getuserliquidity

Returns the balance of a particular token pair of an account.

GET https://api.expand.network/dex/getuserliquidity

Query Parameters

Name
Type
Description

rpc

String

Remote procedural call URL.

tokenId*

String

The token ID for Aerodrome liquidity position.

dexId*

String

Refer to DexId page for details.

https://api.expand.network/dex/getuserliquidity?dexId=3600&tokenId=6402229

back to top

/getpoolliquidity

Returns the total liquidity for a specified pool.

GET https://api.expand.network/dex/getpoolliquidity

Query Parameters

Name
Type
Description

rpc

String

Remote procedural call URL.

poolAddress*

String

Pool address whose liquidity is to be fetched.

dexId*

String

Refer to DEX ID page for details.

https://api.expand.network//dex/getpoolliquidity?dexId=3600&poolAddress=0x6446021F4E396dA3df4235C62537431372195D38

back to top

/gettokenliquidity

Returns the individual token liquidity within the specified liquidity pool.

GET https://api.expand.network/dex/gettokenliquidity

Query Parameters

Name
Type
Description

rpc

String

Remote procedural call URL.

poolAddress*

String

The pool address.

dexId*

String

Refer to DEX ID page for details.

https://api.expand.network//dex/gettokenliquidity?dexId=3600&poolAddress=0xC96fa108B551E24609bA22F177a652FFAa05E3a5

back to top

/getpool

Returns poolAddress, tickSpacing, tokensLiquidity and liquidity data based on tokenA and tokenB

GET https://api.expand.network/dex/getpool

Query Parameters

Name
Type
Description

rpc

String

Remote procedural call URL.

tokenA*

String

TokenA address

dexId

String

Refer to DEX ID page for details.

tokenB*

String

TokenB address

https://api.expand.network/dex/getpool?dexId=3600&tokenA=0x4200000000000000000000000000000000000006&tokenB=0xacfE6019Ed1A7Dc6f7B508C02d1b04ec88cC21bf

/swap

Initiate a swap transaction on a specified DEX.

POST https://api.expand.network/dex/swap

Request Body

Name
Type
Description

rpc

String

Remote procedural call URL.

dexId*

String

Refer to the DEX ID page for details.

path*

Array

Comma-separated values of token addresses, inside an array, to swap.

amountIn*

String

Amount of token to be swapped.

amountOutMin*

String

Minimum amount accepted as a result of swap.

to*

String

Address of the recipient of the token.

from*

String

Address of the sender of the token.

gas*

String

Maximum gas limit provided by the sender, for the transaction.

involveBaseToken

String

If a base token is involved in the swap; 0 for erc20 -> erc20, 1 for base -> erc20 ("from" address should be of equivalent wrapped token), 2 for erc20 -> base ("to" address should be of equivalent wrapped token). By default, 0.

tickSpacing

String

Different pool based on the tick spacing. By default, it is selected as 100.

gasPriority

String

low, medium, or high.

slippage

String

Percentage of total swap value. By default, 1.

0 <= slippage value <= 100

{
    "path": [
        "0x4200000000000000000000000000000000000006",
        "0xcbB7C0000aB88B473b1f5aFd9ef808440eed33Bf"
    ],
    "amountIn": "1017533960529743",
    "amountOutMin": "0",
    "involveBaseToken": "2",
    "gas": "100000",
    "tickSpacing": "100",
    "deadline": "1747703271",
    "from": "0x6A00277E6F9E5b5773772BDE0f8F154f2875Dc26",
    "to": "0x6A00277E6F9E5b5773772BDE0f8F154f2875Dc26",
    "dexId": "3600"
}

With gasPriority (medium):

{
    "path": [
        "0x4200000000000000000000000000000000000006",
        "0xcbB7C0000aB88B473b1f5aFd9ef808440eed33Bf"
    ],
    "amountIn": "1017533960529743",
    "amountOutMin": "0",
    "involveBaseToken": "2",
    "gas": "100000",
    "tickSpacing": "100",
    "deadline": "1747703271",
    "from": "0x6A00277E6F9E5b5773772BDE0f8F154f2875Dc26",
    "to": "0x6A00277E6F9E5b5773772BDE0f8F154f2875Dc26",
    "dexId": "3600",
    "gasPriority": "medium"
}

back to top

/addliquidity

Add liquidity to a specified pool in a specified DEX.

POST https://api.expand.network/dex/addliquidity

Request Body

Name
Type
Description

dexId*

String

Refer to the DEX ID page for details.

tokenA*

String

Address of the first token being added.

tokenB*

String

Address of the second token being added.

tickSpacing

String

Different pool based on the tick spacing. By default, it is selected as 100.

amountADesired*

String

Desired amount of token A.

amountBDesired*

String

Desired amount of token B.

amountAMin*

String

Minimum amount of token A.

amountBMin*

String

Minimum amount of token B.

deadline*

String

Deadline for the transaction to be executed (UNIX Timestamp).

to*

String

Address of the recipient of the token.

from*

String

Address of the sender of the token.

gas*

String

Maximum gas limit provided by the sender, for the transaction.

rpc

String

Remote procedural call URL.

tokenId

String

The token ID for Aerodrome liquidity position.

gasPriority

String

low, medium, or high.

slippage

String

Percentage of total value. By default, 1.

0 <= slippage value <= 100

{
    "tokenA": "0x4200000000000000000000000000000000000006",
    "tokenB": "0xcbB7C0000aB88B473b1f5aFd9ef808440eed33Bf",
    "tickSpacing": "100",
    "amountADesired": "10000000000000",
    "amountBDesired": "24437",
    "amountAMin": "0",
    "amountBMin": "0",
    "from": "0xDb8b672ce5aE1Cb537EEd31b2a61dFEef1feA65a",
    "to": "0xDb8b672ce5aE1Cb537EEd31b2a61dFEef1feA65a",
    "deadline": "1740727106",
    "gas": "10000",
    "dexId": "3600"
}

With gasPriority (medium):

{
    "tokenA": "0x4200000000000000000000000000000000000006",
    "tokenB": "0xcbB7C0000aB88B473b1f5aFd9ef808440eed33Bf",
    "tickSpacing": "100",
    "amountADesired": "10000000000000",
    "amountBDesired": "24437",
    "amountAMin": "0",
    "amountBMin": "0",
    "from": "0xDb8b672ce5aE1Cb537EEd31b2a61dFEef1feA65a",
    "to": "0xDb8b672ce5aE1Cb537EEd31b2a61dFEef1feA65a",
    "deadline": "1740727106",
    "gas": "10000",
    "dexId": "3600",
     "gasPriority": "medium"
}

back to top

/removeliquidity

Remove liquidity from a specified pool for a specified DEX.

POST https://api.expand.network/dex/removeliquidity

Request Body

Name
Type
Description

dexId*

String

Refer to the DEX ID page for details.

tokenId*

String

The token ID for Aerodrome liquidity position.

amountAMin

String

Minimum amount of Token A.

amountAMax

String

Maximum amount of Token A.

amountBMax

String

Maximum amount of Token B.

to*

String

Recipient for sweep tokens.

deadline*

String

Deadline for the transaction to be executed (UNIX Timestamp).

from*

String

Address of the sender of the token.

gas*

String

Maximum gas limit provided by the sender, for the transaction.

rpc

String

Remote procedural call URL.

tokenA*

String

Address of the first token being removed.

tokenB

String

Address of the second token being removed.

liquidity*

string

The liquidity to be removed.

amountBMin

String

Minimum amount of Token B.

gasPriority

String

low, medium, or high.

slippage

String

Percentage of total value. By default, 1.

0 <= slippage value <= 100

{
    "tokenA": "0x4200000000000000000000000000000000000006",
    "tokenB": "0x4F9Fd6Be4a90f2620860d680c0d4d5Fb53d1A825",
    "tickSpacing": "50",
    "liquidity": "10000000000000",
    "amountAMin": "0",
    "amountBMin": "0",
    "from": "0x67d12A43b726C58412Eb9CD1EaF3f4aC16381dEC",
    "to": "0x67d12A43b726C58412Eb9CD1EaF3f4aC16381dEC",
    "deadline": "1840727106",
    "gas": "10000",
    "tokenId": "6762916",
    "dexId": "3600"
}

With gasPriority:

{
    "tokenA": "0x4200000000000000000000000000000000000006",
    "tokenB": "0x4F9Fd6Be4a90f2620860d680c0d4d5Fb53d1A825",
    "tickSpacing": "50",
    "liquidity": "10000000000000",
    "amountAMin": "0",
    "amountBMin": "0",
    "from": "0x67d12A43b726C58412Eb9CD1EaF3f4aC16381dEC",
    "to": "0x67d12A43b726C58412Eb9CD1EaF3f4aC16381dEC",
    "deadline": "1840727106",
    "gas": "10000",
    "tokenId": "6762916",
    "dexId": "3600",
    "gasPriority": "medium"
}

back to top

Last updated