Balancer v2

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

Supported Mainnet Token Pairs (For add & remove liquidity)

1. WETH/DAI 0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2, 0x6B175474E89094C44Da98b954EedeAC495271d0F

2. wstETH/WETH 0x7f39C581F595B53c5cb19bD0b3f8dA6c935E2Ca0, 0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2

3. BAL/WETH 0xba100000625a3754423978a60c9317c58a424e3D, 0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2

4. gOHM/DAI/WETH 0x0ab87046fBb341D058F17CBC4c1133F25a20a52f, 0x6B175474E89094C44Da98b954EedeAC495271d0F, 0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2

5. rETH/WETH 0xae78736Cd615f374D3085123A210448E74Fc6393, 0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2

6. wstETH/bb-a-USD 0x7f39C581F595B53c5cb19bD0b3f8dA6c935E2Ca0, 0xA13a9247ea42D743238089903570127DdA72fE44

7. STG/bb-a-USD 0xAf5191B0De278C7286d6C7CC6ab6BB8A73bA2Cd6, 0xA13a9247ea42D743238089903570127DdA72fE44

8. auraBAL/B-80BAL-20WETH 0x616e8BfA43F920657B3497DBf40D6b1A02D4608d, 0x5c6Ee304399DBdB9C8Ef030aB642B10820DB8F56

9. GNO/WETH 0x6810e776880c02933d47db1b9fc05908e5386b96, 0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2

10. TEMPLE/DAI 0x470EBf5f030Ed85Fc1ed4C2d36B9DD02e77CF1b7, 0x6B175474E89094C44Da98b954EedeAC495271d0F

11. RPL/rETH 0xd33526068d116ce69f19a9ee46f0bd304f21a51f, 0xae78736cd615f374d3085123a210448e74fc6393

12. BADGER/WBTC 0x3472a5a71965499acd81997a54bba8d852c6e53d, 0x2260fac5e5542a773aa44fbcfedf7c193bc2c599

13. WETH/AKITA 0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2, 0x3301Ee63Fb29F863f2333Bd4466acb46CD8323E6

14. AURA/WETH 0xc0c293ce456ff0ed870add98a0828dd4d2903dbf, 0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2

15. rETH/bb-a-USD 0xae78736Cd615f374D3085123A210448E74Fc6393, 0xa13a9247ea42d743238089903570127dda72fe44

16. NOTE/WETH 0xcfeaead4947f0705a14ec42ac3d44129e1ef3ed5, 0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2

17. DIGG/WBTC/graviAURA 0x798D1bE841a82a273720CE31c822C61a67a601C3, 0x2260fac5e5542a773aa44fbcfedf7c193bc2c599, 0xba485b556399123261a5f9c95d413b4f93107407

18. rETH/BADGER 0xae78736Cd615f374D3085123A210448E74Fc6393, 0x3472A5A71965499acd81997a54BBA8D852C6E53d

19. COMP/wstETH 0xc00e94cb662c3520282e6f5717214004a7f26888, 0x7f39c581f595b53c5cb19bd0b3f8da6c935e2ca0

20. COW/GNO 0xDEf1CA1fb7FBcDC777520aa7f396b4E015F497aB, 0x6810e776880C02933D47DB1b9fc05908e5386b96

21. WETH/LINK 0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2, 0x514910771AF9Ca656af840dff83E8264EcF986CA

Supported Testnet Token Pairs (For add & remove liquidity)

1. USDC/WETH 0xe0C9275E44Ea80eF17579d33c55136b7DA269aEb, 0xdFCeA9088c8A88A76FF74892C1457C17dfeef9C1

2. wstETH/WETH 0x6320cD32aA674d2898A68ec82e869385Fc5f7E2f, 0xdFCeA9088c8A88A76FF74892C1457C17dfeef9C1

/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=1400&path=0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2,0x6B175474E89094C44Da98b954EedeAC495271d0F&amountIn=10000000000000000000

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

Sample Request

https://api.expand.network/dex/getuserliquidity?tokenA=0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2&tokenB=0x6b175474e89094c44da98b954eedeac495271d0f&address=0x6fb447ae94f5180254d436a693907a1f57696900&dexId=1400

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.

Sample Request

https://api.expand.network/dex/getpoolliquidity?dexId=1400&poolAddress=0x25Accb7943Fd73Dda5E23bA6329085a3C24bfb6a

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=1400&poolAddress=0x25Accb7943Fd73Dda5E23bA6329085a3C24bfb6a

Sample Response

/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=1400&poolAddress=0x1b65fe4881800B91d4277ba738b567CbB200A60d

Sample Response

/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.
poolAddresses	String	The pool Addresses whose liquidity is to be fetched. (Comma-separated vaules)

Sample Request

https://api.expand.network/dex/getindividualposition?address=0xc29562b045D80fD77c69Bec09541F5c16fe20d9d&dexId=1400&poolAddresses=0xc29562b045D80fD77c69Bec09541F5c16fe20d9d

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.
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.
swapKind*	String	The type of batch swap we want to perform.
deadline*	String	Deadline for the transaction to be executed (UNIX Timestamp).
gasPriority	String	low, medium, or high.
slippage	String	Percentage of total swap value. By default, 1. 0 <= slippage value <= 10

Sample Request

{
    "dexId": "1400",
    "swapKind": "0",
    "path": [
        "0xae78736Cd615f374D3085123A210448E74Fc6393",
        "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2"
    ],
    "amountIn": "100000",
    "gas": "800000",
    "from": "0x63056E00436Da25BcF48A40dfBbDcc7089351006",
    "deadline": "1668973383"
}

Sample Response

Sample Request

With gasPriority:

{
    "dexId": "1400",
    "swapKind": "0",
    "path": [
        "0xae78736Cd615f374D3085123A210448E74Fc6393",
        "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2"
    ],
    "amountIn": "100000",
    "gas": "800000",
    "gasPriority": "medium",
    "from": "0x4C99D660A51D41bE5D47D66a3d89d5B83D92f27E",
    "deadline": "1668973383"
}

Sample Response

Sample Request

With slippage:

{
    "dexId": "1400",
    "swapKind": "0",
    "path": [
        "0xae78736Cd615f374D3085123A210448E74Fc6393",
        "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2"
    ],
    "amountIn": "100000",
    "gas": "800000",
    "from": "0x63056E00436Da25BcF48A40dfBbDcc7089351006",
    "deadline": "1668973383",
    "slippage": "5"
}

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.
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.
fromInternalBalance*	Boolean	True if sending from internal token balances. False if sending ERC20.
to*	String	Address of the recipient of the token.
gasPriority	String	low, medium, or high.
slippage	String	Percentage of total swap value. By default, 1. 0 <= slippage value <= 10

Sample Request

{
    "dexId": "1400",
    "path": ["0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2", "0x6B175474E89094C44Da98b954EedeAC495271d0F"],
    "amountIn": ["0","100000000"],
    "amountOut": "2331262690208301876",
    "fromInternalBalance": false,
    "gas": "2307200",
    "from": "0x63056E00436Da25BcF48A40dfBbDcc7089351006",
    "to": "0x63056E00436Da25BcF48A40dfBbDcc7089351006"
}

Sample Response

Sample Request

With gasPriority:

{
    "dexId": "1400",
    "amountIn": [
        "1000000000000000000",
        "1000000000000000000"
    ],
    "amountOut": "0",
    "path": [
        "0x6B175474E89094C44Da98b954EedeAC495271d0F",
        "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2"
    ],
    "to": "0xDeBB1a42a27051FD18d6d6C2055A44d330A4D80a",
    "deadline": "1710209834351",
    "from": "0xDeBB1a42a27051FD18d6d6C2055A44d330A4D80a",
    "gas": "273376",
    "fromInternalBalance": false,
    "gasPriority": "low"
}

Sample Response

Sample Request

With slippage:

{
    "dexId": "1400",
    "path": [
        "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
        "0x6B175474E89094C44Da98b954EedeAC495271d0F"
    ],
    "amountIn": [
        "0",
        "100000000"
    ],
    "amountOut": "2331262690208301876",
    "fromInternalBalance": false,
    "gas": "2307200",
    "from": "0x63056E00436Da25BcF48A40dfBbDcc7089351006",
    "to": "0x63056E00436Da25BcF48A40dfBbDcc7089351006",
    "slippage": "7.02"
}

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.
path*	Array	Comma separated values of token addresses.
amountIn*	String	Amount of tokens to add 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.
toInternalBalance*	Boolean	True if you receiving tokens as internal token balances. False if receiving as ERC20.
to*	String	Address of the recipient of the token.
gasPriority	String	low, medium, or high.
slippage	String	Percentage of total swap value. By default, 1. 0 <= slippage value <= 10

Sample Request

{
    "dexId": "1400",
    "path": ["0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2", "0x6B175474E89094C44Da98b954EedeAC495271d0F"],
    "amountOut": ["0","100000000"],
    "amountIn": "2427326557218525461",
    "toInternalBalance": false,
    "gas": "2307200",
    "from": "0x63056E00436Da25BcF48A40dfBbDcc7089351006",
    "to": "0x63056E00436Da25BcF48A40dfBbDcc7089351006"
}

Sample Response

Sample Request

With gasPriority (medium):

{
    "dexId": "1400",
    "path": [
        "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
        "0x6B175474E89094C44Da98b954EedeAC495271d0F"
    ],
    "amountOut": [
        "100",
        "100000000"
    ],
    "amountIn": "2427326557218525461",
    "toInternalBalance": false,
    "gas": "2307200",
    "from": "0x63056E00436Da25BcF48A40dfBbDcc7089351006",
    "to": "0x63056E00436Da25BcF48A40dfBbDcc7089351006",
    "gasPriority": "medium"
}

Sample Response

Sample Request

With Slippage:

{
    "dexId": "1400",
    "path": [
        "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
        "0x6B175474E89094C44Da98b954EedeAC495271d0F"
    ],
    "amountOut": [
        "100",
        "100000000"
    ],
    "amountIn": "2427326557218525461",
    "toInternalBalance": false,
    "gas": "2307200",
    "from": "0x63056E00436Da25BcF48A40dfBbDcc7089351006",
    "to": "0x63056E00436Da25BcF48A40dfBbDcc7089351006",
    "slippage": "6.01"
}

Sample Response