V2 DEX Add Liquidity
Add liquidity to V2-compatible DEX pools (Uniswap V2, SushiSwap, PancakeSwap). Supports token/token and token/ETH pairs. Returns LP tokens representing pool share. Configurable slippage protection and deadline. Ideal for: liquidity provision, yield farming, earning trading fees, LP token strategies.
Catalog action EVM Onchain wallet Gas send
Add liquidity to V2-compatible DEX pools (Uniswap V2, SushiSwap, PancakeSwap). Supports token/token and token/ETH pairs. Returns LP tokens representing pool share. Configurable slippage protection and deadline. Ideal for: liquidity provision, yield farming, earning trading fees, LP token strategies.
This action can require a wallet connector, gas, token movement, or an external side effect. Test with simulation or a controlled amount before using it in a live workflow.
At a Glance
| Field | Value |
|---|---|
| Action ID | v2-add-liquidity |
| Category | EVM Onchain |
| Connector | wallet |
| Requires gas | Yes |
| Funds movement | send |
| Tags | blockchain, evm, dex, liquidity, lp, amm, defi, v2 |
Payload Schema
| Field | Type | Required | Description |
|---|---|---|---|
chainId | number | Yes | Chain |
tokenA | string | Yes | First token address (use 0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE for native ETH) |
amountADesired | string | No | Desired amount of tokenA to add (in wei/smallest unit). At least one of amountADesired or amountBDesired must be provided. If only one is provided, the other will be auto-calculated from pool reserves. Both required when creating a new pool. |
tokenB | string | Yes | Second token address (use 0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE for native ETH) |
amountBDesired | string | No | Desired amount of tokenB to add (in wei/smallest unit). At least one of amountADesired or amountBDesired must be provided. If only one is provided, the other will be auto-calculated from pool reserves. Both required when creating a new pool. |
slippageBps | number | No | Slippage tolerance in basis points (100 = 1%). Default: 50 (0.5%) |
deadlineMinutes | number | No | Transaction deadline in minutes from now. Default: 20 |
routerAddress | string | No | Optional custom router address. If not provided, uses default V2 router for the chain. |
Result Schema
| Field | Type | Required | Description |
|---|---|---|---|
status | string | Yes | - |
transactionHash | string | Yes | The transaction hash |
amountA | string | No | Actual amount of tokenA added to the pool |
amountB | string | No | Actual amount of tokenB added to the pool |
liquidity | string | No | Amount of LP tokens received |
pairAddress | string | No | Address of the liquidity pair |
Examples
json{ "type": "v2-add-liquidity", "payload": { "tokenA": "ETH", "tokenB": "ETH", "chainId": 8453 }, "children": [], "connector": { "type": "wallet", "id": "conn_wallet" }}
bashcurl -X POST "https://api.b3os.org/v1/actions/v2-add-liquidity/test" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "inputs": { "tokenA": "ETH", "tokenB": "ETH", "chainId": 8453 }}'
Payload fields can use workflow expressions such as {{$trigger.body.amount}}, {{$nodes.fetch.result.price}}, and {{$props.asset}} when the value should come from a trigger, prior node, or reusable workflow prop.