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

NameTypeDescription

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.

https://api.expand.network/dex/getprice?dexId=1400&path=0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2,0x6B175474E89094C44Da98b954EedeAC495271d0F&amountIn=10000000000000000000

/getuserliquidity

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

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

Query Parameters

NameTypeDescription

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.

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

/getpoolliquidity

Returns the total liquidity for a specified pool.

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

Query Parameters

NameTypeDescription

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

/gettokenliquidity

Returns the individual token liquidity within the specified liquidity pool.

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

Query Parameters

NameTypeDescription

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

/getliquidityholders

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

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

Query Parameters

NameTypeDescription

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

/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

NameTypeDescription

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)

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

/swap

Initiate a swap transaction on a specified DEX.

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

Request Body

NameTypeDescription

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

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

With gasPriority:

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

With slippage:

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

/addliquidity

Add liquidity to a specified pool in a specified DEX.

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

Request Body

NameTypeDescription

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

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

With gasPriority:

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

With slippage:

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

/removeliquidity

Remove liquidity from a specified pool for a specified DEX.

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

Request Body

NameTypeDescription

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

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

With gasPriority (medium):

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

With Slippage:

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

Last updated