Curve v2

Below is the list of tokens we currently support for these endpoints. We are happy to add support for additional tokens upon request.

Supported Mainnet Token Pairs

1. steth - ETH/stETH 0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee, 0xae7ab96520de3a18e5e111b5eaab095312d7fe84

2. threepool - DAI/USDC/USDT 0x6b175474e89094c44da98b954eedeac495271d0f, 0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48, 0xdac17f958d2ee523a2206206994597c13d831ec7

3. FRAXsDAI - FRAX/sDAI 0x853d955acef822db058eb8505911ed77f175b99e, 0x83f20f44975d03b1b09e64809b757c47f942beea

4. FRAXPYUSD - FRAX/PYUSD 0x853d955acef822db058eb8505911ed77f175b99e, 0x6c3ea9036406852006290770bedfcaba0e23a0e8

5. frxETHWETH - WETH/frxETH 0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2, 0x5e8422345238f34275888049021821e8e08caa1f

6. stETHng - ETH/stETH 0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee, 0xae7ab96520de3a18e5e111b5eaab095312d7fe84

7. fraxusdc - FRAX/USDC 0x853d955acef822db058eb8505911ed77f175b99e, 0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48

8. tricrypto2 - USDT/WBTC/WETH 0xdac17f958d2ee523a2206206994597c13d831ec7, 0x2260fac5e5542a773aa44fbcfedf7c193bc2c599, 0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2

9. TriCryptoUSDT - USDT/WBTC/WETH 0xdac17f958d2ee523a2206206994597c13d831ec7, 0x2260fac5e5542a773aa44fbcfedf7c193bc2c599, 0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2

10. stETHfrxETH - stETH/frxETH 0xae7ab96520de3a18e5e111b5eaab095312d7fe84, 0x5e8422345238f34275888049021821e8e08caa1f

11. alUSDFRAXBP - alUSD/FRAX/BASIS 0xbc6da0fe9ad5f3b0d58160288917aa56653660e9, 0x3175df0976dfa876431c2e9ee6bc45b65d3473cc

12. PayPool - PYUSD/USDC 0x6c3ea9036406852006290770bedfcaba0e23a0e8, 0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48

13. mkUSDUSDC - mkUSD/USDC 0x4591dbff62656e7859afe5e45f6f47d3669fbb28, 0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48

14. TriCryptoUSDC - USDC/WBTC/WETH 0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48, 0x2260fac5e5542a773aa44fbcfedf7c193bc2c599, 0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2

15. frxeth - ETH/frxETH 0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee, 0x5e8422345238f34275888049021821e8e08caa1f

16. OETH - ETH/OETH 0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee, 0x856c4efb76c1d1ae02e20ceb03a2a6a08b0b8dc3

17. cvxCrvCrv - cvxCrv/Crv 0xd533a949740bb3306d119cc777fa900ba034cd52, 0x62b9c7356a2dc64a1969e19c23e4f579f9810aa7

18. ETHxwstETH - ETHx/wstETH 0x7f39c581f595b53c5cb19bd0b3f8da6c935e2ca0, 0xa35b1b31ce002fbf2058d22f30f95d405200a15b

19. cvxFxsFxs - cvxFXS/FXS 0x3432b6a60d23ca0dfca7761b7ab56459d9c964d0, 0xfeef77d3f69374f66429c91d732a244f074bdf74

20. FRAXFPI - FRAX/FPI 0x853d955acef822db058eb8505911ed77f175b99e, 0x5ca135cb8527d76e932f34b5145575f9d8cbe08e

21. mim - MIM/DAI/USDC/USDT 0x99d8a9c45b2eca8864373a26d1459e3dff1e17f3, 0x6c3f90f043a72fa612cbac8115ee7e52bde6e490

22. crvUSDUSDC - USDC/crvUSD 0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48, 0xf939e0a03fb07f59a73314e73794be0e57ac1b4e

23. alETHfrxETH - alETH/frxETH 0x0100546f2cd4c9d97f798ffc9755e47865ff7ee6, 0x5e8422345238f34275888049021821e8e08caa1f

24. aave - DAI/USDC/USDT 0x028171bca77440897b824ca71d1c56cac55b68a3, 0xbcca60bb61934080951369a648fb03df4f96263c, 0x3ed3b47dd13ec9a98b44e6204a523e766b225811

25. crvUSDUSDT - USDT/crvUSD 0xdac17f958d2ee523a2206206994597c13d831ec7, 0xf939e0a03fb07f59a73314e73794be0e57ac1b4e

/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=1500&path=0x6b175474e89094c44da98b954eedeac495271d0f,0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48&amountIn=10000000000000000000

Sample Response

{
    "status": 200,
    "msg": "success",
    "data": {
        "amountIn": "10000000000000000000",
        "path": [
            "0x6b175474e89094c44da98b954eedeac495271d0f",
            "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"
        ],
        "amountsOut": [
            "10000000000000000000",
            "9998342"
        ]
    }
}

/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	Address of token.
address*	String	Public address of liquidity provider.
dexId*	String	Refer to DEX ID page for details.
tokenB*	String	Address of token.
tokenC	String	Address of token.
tokenD	String	Address of token.

Sample Request

https://api.expand.network/dex/getuserliquidity?address=0x6fb447ae94f5180254d436a693907a1f57696900&dexId=1500&tokenA=0x6b175474e89094c44da98b954eedeac495271d0f&tokenB=0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48&tokenC=0xdac17f958d2ee523a2206206994597c13d831ec7

Sample Response

{
    "status": 200,
    "msg": "success",
    "data": {
        "pairAddress": "0x6c3f90f043a72fa612cbac8115ee7e52bde6e490",
        "tokenA": "0",
        "tokenB": "0",
        "tokenC": "0",
        "liquidity": "0"
    }
}

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

Sample Request

https://api.expand.network/dex/getpoolliquidity?dexId=1500&poolAddress=0xc5424b857f758e906013f3555dad202e4bdb4567

Sample Response

{
    "status": 200,
    "msg": "success",
    "data": {
        "totalLiquidity": "6906912970691008135418"
    }
}

/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=1500&poolAddress=0xdebf20617708857ebe4f679508e7b7863a8a8eee

Sample Response

{
    "status": 200,
    "msg": "success",
    "data": {
        "aDAI": "4410821251140993186643520",
        "aUSDC": "4427459634996",
        "aUSDT": "12345097594917"
    }
}

/getliquidityholders

Returns the total number of liquidity holders in the specified pool.

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

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/getliquidityholders?dexId=1500&poolAddress=0xed279fdd11ca84beef15af5d39bb4d4bee23f0ca

Sample Response

{
    "status": 200,
    "msg": "success",
    "data": {
        "totalTokenHolders": 1467
    }
}

/getindividualposition

Returns the liquidity position for a specified user address across all the pools for the DEX.

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

Query Parameters

Name	Type	Description
rpc	String	Remote procedural call URL.
address*	String	The public address of the liquidity holder.
dexId*	String	Refer to DEX ID page for details.

Sample Request

https://api.expand.network/dex/getindividualposition?address=0x9bb98140F36553dB71fe4a570aC0b1401BC61B4F&dexId=1500

Sample Response

{
    "status": 200,
    "msg": "success",
    "data": {
        "aggregatedLiquidity": "1807177360143696334",
        "poolAddresses": {
            "DAIUSDCUSDT": {
                "0xbebc44782c7db0a1a60cb6fe97d0b483032ff1c7": "1797671437464531430"
            },
            "ETHstETH": {
                "0xdc24316b9ae028f1497c275eb9192a3ea0f67022": "9505922679164904"
            }
        }
    }
}

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

Sample Request

{
    "status": 200,
    "msg": "success",
    "data": {
        "chainId": "1",
        "from": "0x63056E00436Da25BcF48A40dfBbDcc7089351006",
        "to": "0xdc24316b9ae028f1497c275eb9192a3ea0f67022",
        "value": "0",
        "gas": "800000",
        "data": "0x3df021240000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000038d7ea4c6800000000000000000000000000000000000000000000000000000038eeabe1721a0"
    }
}

Sample Response

{
    "status": 200,
    "msg": "success",
    "data": {
        "chainId": "1",
        "from": "0x63056E00436Da25BcF48A40dfBbDcc7089351006",
        "to": "0x828b154032950c8ff7cf8085d841723db2696056",
        "value": "0",
        "gas": "800000",
        "data": "0x3df021240000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000038d7ea4c68000000000000000000000000000000000000000000000000000000009382b488300"
    }
}

Sample Request

With gasPriority:

{
    "dexId": "1500",
    "path": [
        "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",
        "0xae7ab96520de3a18e5e111b5eaab095312d7fe84"
    ],
    "amountIn": "1000000000000",
    "amountOutMin": "101368",
    "gas": "800000",
    "from": "0x6Fb447Ae94F5180254D436A693907a1f57696900",
    "gasPriority": "medium"
}

Sample Response

With gasPriority:

{
    "status": 200,
    "msg": "success",
    "data": {
        "chainId": "1",
        "from": "0x6Fb447Ae94F5180254D436A693907a1f57696900",
        "to": "0xdc24316b9ae028f1497c275eb9192a3ea0f67022",
        "value": "0",
        "gas": "800000",
        "data": "0x3df0212400000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001000000000000000000000000000000000000000000000000000000e8d4a51000000000000000000000000000000000000000000000000000000000e931d5cd91",
        "gasPrice": "18986175337"
    }
}

Sample Request

With Slippage:

{
    "dexId": "1500",
    "amountIn": "1000000",
    "amountOutMin": "949846",
    "path": [
        "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
        "0xdAC17F958D2ee523a2206206994597C13D831ec7"
    ],
    "to": "0x22cf65ae3fa16d6379e72f4b4c2401c1b7c69731",
    "deadline": "1711931771",
    "from": "0x22cf65ae3fa16d6379e72f4b4c2401c1b7c69731",
    "gas": "933376",
    "slippage": "4"
}

Sample Response

With Slippage:

{
    "status": 200,
    "msg": "success",
    "data": {
        "chainId": "1",
        "from": "0x22cf65ae3fa16d6379e72f4b4c2401c1b7c69731",
        "to": "0xbebc44782c7db0a1a60cb6fe97d0b483032ff1c7",
        "value": "0",
        "gas": "933376",
        "data": "0x3df021240000000000000000000000000000000000000000000000000000000000000001000000000000000000000000000000000000000000000000000000000000000200000000000000000000000000000000000000000000000000000000000f424000000000000000000000000000000000000000000000000000000000000ea423"
    }
}

/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.
path*	Array	Comma separated values of token addresses.
amountIn*	Array	Amount of tokens to add liquidity.
amountOut*	String	Amount of tokens accepted as a result of the transaction.
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.
slippage	String	Percentage of total value. By default, 1. 0 <= slippage value <= 10
gasPriority	String	low, medium, or high.

Sample Request

{
    "dexId":  "1500",
    "path": [ "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee", "0xae7ab96520de3a18e5e111b5eaab095312d7fe84" ],
    "amountIn":   [ "100000000000000", "10000000000000" ], 
    "amountOut":  "10136848990976",
    "gas":  "800000",
    "from": "0x63056E00436Da25BcF48A40dfBbDcc7089351006"
}

Sample Response

{
    "status": 200,
    "msg": "success",
    "data": {
        "chainId": "1",
        "from": "0x63056E00436Da25BcF48A40dfBbDcc7089351006",
        "to": "0x21e27a5e5513d6e65c4f830167390997aa84843a",
        "value": "0",
        "gas": "800000",
        "data": "0x0b4c7e4d00000000000000000000000000000000000000000000000000005af3107a4000000000000000000000000000000000000000000000000000000009184e72a000000000000000000000000000000000000000000000000000000009382b488300"
    }
}

Sample Request

With gasPriority:

{
    "dexId": "1500",
    "path": [
        "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",
        "0xae7ab96520de3a18e5e111b5eaab095312d7fe84"
    ],
    "amountIn": [
        "100000000000000",
        "10000000000000"
    ],
    "amountOut": "10136848990976",
    "gas": "800000",
    "gasPriority": "high",
    "from": "0x6Fb447Ae94F5180254D436A693907a1f57696900"
}

Sample Response

With gasPriority:

{
    "status": 200,
    "msg": "success",
    "data": {
        "chainId": "1",
        "from": "0x6Fb447Ae94F5180254D436A693907a1f57696900",
        "to": "0x21e27a5e5513d6e65c4f830167390997aa84843a",
        "value": "10000000000000",
        "gas": "800000",
        "data": "0x0b4c7e4d00000000000000000000000000000000000000000000000000005af3107a4000000000000000000000000000000000000000000000000000000009184e72a000000000000000000000000000000000000000000000000000000009382b488300",
        "gasPrice": "22126108083"
    }
}

Sample Request

With slippage:

{
    "dexId":  "1500",
    "path": [ "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee", "0xae7ab96520de3a18e5e111b5eaab095312d7fe84" ],
    "amountIn":   [ "100000000000000", "10000000000000" ], 
    "amountOut":  "10136848990976",
    "gas":  "800000",
    "from": "0x63056E00436Da25BcF48A40dfBbDcc7089351006",
    "slippage":"2.0001"
}

Sample Response

With slippage:

{
    "status": 200,
    "msg": "success",
    "data": {
        "chainId": "1",
        "from": "0x63056E00436Da25BcF48A40dfBbDcc7089351006",
        "to": "0x21e27a5e5513d6e65c4f830167390997aa84843a",
        "value": "0",
        "gas": "800000",
        "data": "0x0b4c7e4d00000000000000000000000000000000000000000000000000005af3107a4000000000000000000000000000000000000000000000000000000009184e72a00000000000000000000000000000000000000000000000000000000908f69d0683"
    }
}

/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.
path*	Array	Comma separated values of token addresses.
amountIn*	String	Amount of tokens to remove liquidity.
amountOut*	Array	Amount of tokens accepted as a result of the transaction.
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.
slippage	String	Percentage of total value. By default, 1. 0 <= slippage value <= 10
gasPriority	String	low, medium, or high.

Sample Request

{
    "status": 200,
    "msg": "success",
    "data": {
        "chainId": "1",
        "from": "0x63056E00436Da25BcF48A40dfBbDcc7089351006",
        "to": "0x21e27a5e5513d6e65c4f830167390997aa84843a",
        "value": "0",
        "gas": "800000",
        "data": "0x5b36389c00000000000000000000000000000000000000000000000000000000000f424000000000000000000000000000000000000000000000000000005af3107a4000000000000000000000000000000000000000000000000000000009184e72a000"
    }
}

Sample Response

{
    "status": 200,
    "msg": "success",
    "data": {
        "chainId": "1",
        "from": "0x63056E00436Da25BcF48A40dfBbDcc7089351006",
        "to": "0x828b154032950c8ff7cf8085d841723db2696056",
        "value": "0",
        "gas": "800000",
        "data": "0x5b36389c00000000000000000000000000000000000000000000000000000000000f424000000000000000000000000000000000000000000000000000005af3107a4000000000000000000000000000000000000000000000000000000009184e72a000"
    }
}

Sample Request

With gasPriority:

{
    "dexId": "1500",
    "path": [
        "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",
        "0xae7ab96520de3a18e5e111b5eaab095312d7fe84"
    ],
    "amountIn": "1000000",
    "amountOut": [
        "100000000000000",
        "10000000000000"
    ],
    "gas": "800000",
    "gasPriority": "medium",
    "from": "0x63056E00436Da25BcF48A40dfBbDcc7089351006"
}

Sample Response

With gasPriority:

{
    "status": 200,
    "msg": "success",
    "data": {
        "chainId": "1",
        "from": "0x63056E00436Da25BcF48A40dfBbDcc7089351006",
        "to": "0x21e27a5e5513d6e65c4f830167390997aa84843a",
        "value": "0",
        "gas": "800000",
        "data": "0x5b36389c00000000000000000000000000000000000000000000000000000000000f424000000000000000000000000000000000000000000000000000005af3107a4000000000000000000000000000000000000000000000000000000009184e72a000",
        "gasPrice": "17484623740"
    }
}

Sample Request

With Slippage:

{
    "dexId": "1500",
    "path": [
        "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",
        "0xae7ab96520de3a18e5e111b5eaab095312d7fe84"
    ],
    "amountIn": "1000000",
    "amountOut": [
        "100000000000000",
        "10000000000000"
    ],
    "gas": "800000",
    "from": "0x63056E00436Da25BcF48A40dfBbDcc7089351006",
    "slippage": "10"
}

Sample Response

With Slippage:

{
    "status": 200,
    "msg": "success",
    "data": {
        "chainId": "1",
        "from": "0x63056E00436Da25BcF48A40dfBbDcc7089351006",
        "to": "0x21e27a5e5513d6e65c4f830167390997aa84843a",
        "value": "0",
        "gas": "800000",
        "data": "0x5b36389c00000000000000000000000000000000000000000000000000000000000f4240000000000000000000000000000000000000000000000000000051dac207a0000000000000000000000000000000000000000000000000000000082f79cd9000"
    }
}