Trader Joe

/getprice

Returns the swap quotation for the given token pairs.

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

Query Parameters

Name	Type	Description
rpc	String	Remote procedural call URL.
dexId*	String	Refer to the DEX ID page for details.
path*	String	Comma separated values of token addresses whose price is to be fetched.
amountIn*	String	Amount of token.

Sample Request

https://api.expand.network/dex/getprice?dexId=2100&path=0xB31f66AA3C1e785363F0875A1B74E27b85FD66c7%2C0x49D5c2BdFfac6CE2BFdB6640F4F80f226bc10bAB&amountIn=1000000000000000000

Sample Response

/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.
tokenA*	String	Token Address of first token.
dexId*	String	Refer to DexId page for details.
tokenB*	String	Token Address of second token.
address*	String	User public address.
id*	String	Bin ID whose liquidity is to be fetched.

Sample Request

https://api.expand.network/dex/getuserliquidity?tokenA=0xB31f66AA3C1e785363F0875A1B74E27b85FD66c7&tokenB=0xB97EF9Ef8734C71904D8002F8b6Bc66Dd9c48a6E&address=0x41917217DD34CEAd24Daa02b4Ca07bDE9E5FcD1d&dexId=2100&id=8376649

Sample Response

/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.
id*	String	Bin ID whose liquidity is to be fetched.

Sample Request

https://api.expand.network/dex/getpoolliquidity?dexId=2100&poolAddress=0xD446eb1660F766d533BeCeEf890Df7A69d26f7d1&id=8376653

Sample Response

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

Sample Request

https://api.expand.network/dex/gettokenliquidity?dexId=2100&poolAddress=0x9f8973FB86b35C307324eC31fd81Cf565E2F4a63

Sample Response

/swap

Initiate a swap transaction on a specified DEX.

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

Request Body

Name	Type	Description
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.
rpc	String	Remote procedural call URL.
gasPriority	String	low, medium, or high.
slippage	String	Percentage of total swap value. By default, 1. 0 <= slippage value <= 10
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 .
deadline*	String	Deadline for the transaction to be executed (UNIX Timestamp).

Sample Request

{
    "dexId": "2100",
    "amountIn": "10000000000",
    "amountOutMin": "100",
    "path": [
        "0xB31f66AA3C1e785363F0875A1B74E27b85FD66c7",
        "0xB97EF9Ef8734C71904D8002F8b6Bc66Dd9c48a6E"
    ],
    "to": "0xa67E9B68c41b0f26184D64C26e0b2B81466E5994",
    "deadline": "1753156839",
    "from": "0xa67E9B68c41b0f26184D64C26e0b2B81466E5994",
    "gas": "100000"
}

Sample Response

Sample Request

With gasPriority:

{
    "dexId": "2100",
    "amountIn": "10000000000",
    "amountOutMin": "100",
    "path": [
        "0xB31f66AA3C1e785363F0875A1B74E27b85FD66c7",
        "0xB97EF9Ef8734C71904D8002F8b6Bc66Dd9c48a6E"
    ],
    "to": "0xa67E9B68c41b0f26184D64C26e0b2B81466E5994",
    "deadline": "1753156839",
    "from": "0xa67E9B68c41b0f26184D64C26e0b2B81466E5994",
    "gas": "100000",
    "gasPriority": "high"
}

Sample Response

Sample Request

With Slippage:

{
    "dexId": "2100",
    "amountIn": "10000000000",
    "amountOutMin": "100",
    "path": [
        "0xB31f66AA3C1e785363F0875A1B74E27b85FD66c7",
        "0xB97EF9Ef8734C71904D8002F8b6Bc66Dd9c48a6E"
    ],
    "to": "0xa67E9B68c41b0f26184D64C26e0b2B81466E5994",
    "deadline": "1753156839",
    "from": "0xa67E9B68c41b0f26184D64C26e0b2B81466E5994",
    "gas": "100000",
    "slippage": "6"
}

Sample Response

/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.
amountA*	String	Desired amount of token A.
amountB*	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.
gasPriority	String	low, medium, or high.
slippage	String	Percentage of total value. By default, 1. 0 <= slippage value <= 10
strategy	String	spotUniform, curve or bidask. By default, spotUniform.

Sample Request

{
    "dexId": "2100",
    "tokenA": "0xB31f66AA3C1e785363F0875A1B74E27b85FD66c7",
    "tokenB": "0xB97EF9Ef8734C71904D8002F8b6Bc66Dd9c48a6E",
    "amountA": "10000000000000000",
    "amountB": "1000",
    "amountAMin": "1000000000",
    "amountBMin": "100",
    "to": "0xa67E9B68c41b0f26184D64C26e0b2B81466E5994",
    "deadline": "1706678170",
    "from": "0xa67E9B68c41b0f26184D64C26e0b2B81466E5994",
    "gas": "530000",
    "strategy": "bidask"
}

Sample Response

Sample Request

With gasPriority (medium):

{
    "dexId": "2100",
    "tokenA": "0xB31f66AA3C1e785363F0875A1B74E27b85FD66c7",
    "tokenB": "0xB97EF9Ef8734C71904D8002F8b6Bc66Dd9c48a6E",
    "amountA": "10000000000000000",
    "amountB": "1000",
    "amountAMin": "1000000000",
    "amountBMin": "100",
    "to": "0xa67E9B68c41b0f26184D64C26e0b2B81466E5994",
    "deadline": "1706678170",
    "from": "0xa67E9B68c41b0f26184D64C26e0b2B81466E5994",
    "gas": "530000",
    "strategy": "bidask",
    "gasPriority": "medium"
}

Sample Response

Sample Request

With Slippage:

{
    "dexId": "2100",
    "tokenA": "0xB31f66AA3C1e785363F0875A1B74E27b85FD66c7",
    "tokenB": "0xB97EF9Ef8734C71904D8002F8b6Bc66Dd9c48a6E",
    "amountA": "10000000000000000",
    "amountB": "1000",
    "amountAMin": "1000000000",
    "amountBMin": "100",
    "to": "0xa67E9B68c41b0f26184D64C26e0b2B81466E5994",
    "deadline": "1706678170",
    "from": "0xa67E9B68c41b0f26184D64C26e0b2B81466E5994",
    "gas": "530000",
    "strategy": "bidask",
    "slippage": "5"
}

Sample Response

/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.
amountAMin*	String	Minimum amount of Token A.
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.
amountBMin*	String	Minimum amount of Token B.
gasPriority	String	low, medium, or high.
binStep*	String	Difference between two consecutive bins.
ids*	Array	Bin IDs that liquidity should be removed from.
amounts*	Array	LBToken(Liquidity Book Token) amount that should be removed.
to*	String	Address of the recipient of the token.
slippage	String	Percentage of total swap value. By default, 1. 0 <= slippage value <= 10

Sample Request

{
    "dexId": "2100",
    "tokenA": "0xB31f66AA3C1e785363F0875A1B74E27b85FD66c7",
    "tokenB": "0xB97EF9Ef8734C71904D8002F8b6Bc66Dd9c48a6E",
    "amountBMin": "150",
    "amountAMin": "9140195223753",
    "to": "0xa67E9B68c41b0f26184D64C26e0b2B81466E5994",
    "deadline": "1705994811",
    "from": "0xa67E9B68c41b0f26184D64C26e0b2B81466E5994",
    "gas": "0",
    "binStep": "20",
    "ids": [
        "8375816",
        "8375817",
        "8375818",
        "8375819",
        "8375820",
        "8375821",
        "8375822",
        "8375823",
        "8375824",
        "8375825",
        "8375826"
    ],
    "amounts": [
        "6125082604576892342340742933771827806208",
        "6125082604576892342340742933771827806208",
        "6125082604576892342340742933771827806208",
        "6125082604576892342340742933771827806208",
        "6092234575456602778057561670181153099728",
        "27680318192948304012362129290692653566283",
        "49451196782276463859932823798226771515026",
        "49649387794231952910105025177550757137373",
        "49747539066384995844387966236176975326734",
        "49845022333457547462772063936365946907208",
        "49759874534344782452838208519883050222759"
    ]
}

Sample Response

Sample Request

With gasPriority:

{
    "dexId": "2100",
    "tokenA": "0xB31f66AA3C1e785363F0875A1B74E27b85FD66c7",
    "tokenB": "0xB97EF9Ef8734C71904D8002F8b6Bc66Dd9c48a6E",
    "amountBMin": "150",
    "amountAMin": "9140195223753",
    "to": "0xa67E9B68c41b0f26184D64C26e0b2B81466E5994",
    "deadline": "1705994811",
    "from": "0xa67E9B68c41b0f26184D64C26e0b2B81466E5994",
    "gas": "0",
    "gasPriority": "high",
    "binStep": "20",
    "ids": [
        "8375816",
        "8375817",
        "8375818",
        "8375819",
        "8375820",
        "8375821",
        "8375822",
        "8375823",
        "8375824",
        "8375825",
        "8375826"
    ],
    "amounts": [
        "6125082604576892342340742933771827806208",
        "6125082604576892342340742933771827806208",
        "6125082604576892342340742933771827806208",
        "6125082604576892342340742933771827806208",
        "6092234575456602778057561670181153099728",
        "27680318192948304012362129290692653566283",
        "49451196782276463859932823798226771515026",
        "49649387794231952910105025177550757137373",
        "49747539066384995844387966236176975326734",
        "49845022333457547462772063936365946907208",
        "49759874534344782452838208519883050222759"
    ]
}

Sample Response

Sample Request

With Slippage:

{
    "dexId": "2100",
    "tokenA": "0xB31f66AA3C1e785363F0875A1B74E27b85FD66c7",
    "tokenB": "0xB97EF9Ef8734C71904D8002F8b6Bc66Dd9c48a6E",
    "amountBMin": "150",
    "amountAMin": "9140195223753",
    "to": "0xa67E9B68c41b0f26184D64C26e0b2B81466E5994",
    "slippage": "7",
    "deadline": "1705994811",
    "from": "0xa67E9B68c41b0f26184D64C26e0b2B81466E5994",
    "gas": "0",
    "binStep": "20",
    "ids": [
        "8375816",
        "8375817",
        "8375818",
        "8375819",
        "8375820",
        "8375821",
        "8375822",
        "8375823",
        "8375824",
        "8375825",
        "8375826"
    ],
    "amounts": [
        "6125082604576892342340742933771827806208",
        "6125082604576892342340742933771827806208",
        "6125082604576892342340742933771827806208",
        "6125082604576892342340742933771827806208",
        "6092234575456602778057561670181153099728",
        "27680318192948304012362129290692653566283",
        "49451196782276463859932823798226771515026",
        "49649387794231952910105025177550757137373",
        "49747539066384995844387966236176975326734",
        "49845022333457547462772063936365946907208",
        "49759874534344782452838208519883050222759"
    ]
}

Sample Response