Managing Liquidity via the Uniswap API

High Level Message Flow

The following diagram illustrates how an integrator starting with no liquidity position can create and manage a liquidity position. Steps in gray are taken through the Uniswap Labs API and steps in red are written to the blockchain by the integrator.

1. The integrator checks if they have the necessary approval to send token(s) to the desired pool using an /approve request.
   1. If the approval is not yet in place, a fully-formed transaction is returned for the integrator to sign for each un-approved token.
2. The integrator then proposes the position they would like to create using the /create request.
   1. The API checks if the pool already exists. If the pool does not exist, the response returns a fully-formed transaction to create the pool which the user must sign.
   2. The API also returns the fully-formed transaction to create a position (e.g. add liquidity to a pool), which the user must sign.
3. Over time the integrator may want to perform additional actions to manage their liquidity pool (LP) positions:
   1. Commonly, liquidity providers will want to claim their earned fees from the pool using the /claim request.
   2. Integrators may want to change the allocation of tokens they have made to a pool. Integrators can add additional tokens to a pool using the /increase request and can reduce or fully withdraw their position using the /decrease endpoint.
   3. Uniswap Labs continues to innovate on pool contracts, integrators may want to migrate their positions from one version of a pool to another version. the /migrate endpoint allows an integrator to move their liquidity from a Uniswap v3 pool to a Uniswap v4 pool (remaining within the same pair, for example WBTC/USDC).
   4. Certain pools may offer the opportunity to receive rewards for LPing. These rewards can be claimed using the /claim_rewards endpoint.

If you are ready to build, you can grab an API key from the Uniswap Developer Platform.