Custom Linking

Query Parameters

The Uniswap front-end supports URL query parameters to allow for custom linking to the Uniswap frontend. Users and developers can use these query parameters to link to the Uniswap frontend with custom prefilled settings.

Each Page has specific available URL parameters that can be set. Global parameters can be used on all pages.

A parameter used on an incorrect page will have no effect on frontend settings. Parameters not set with a URL parameter will be set to standard frontend defaults.

Global

ParameterTypeDescription
themeStringSets them to dark or light mode.

Theme Options

Theme can be set as light or dark.

Example Usage

https://app.uniswap.org/#/swap?theme=dark

Swap Page

ParameterTypeDescription
inputCurrencyaddressInput currency that will be swapped for output currency.
outputCurrencyaddress or ETHOutput currency that input currency will be swapped for.
exactAmountnumberThe custom token amount to buy or sell.
exactFieldstringThe field to set custom token amount for. Must be input or output.

Defaults

ETH defaults as the input currency. When a different token is selected for either input or output ETH will default as the opposite selected currency.

Constraints

Addresses must be valid ERC20 addresses. Slippage and amount values must be valid numbers accepted by the frontend (or error will prevent from swapping). Slippage can 0, or within the range 10->9999 bips (which converts to 0%, 0.01%->99%)

When selecting ETH as the output currency a user must also choose an inputCurrency that is not ETH (to prevent ETH being populated in both fields)

Setting Amounts

Two parameters, exactField and exactAmount can be used to set specific token amounts to be sold or bought. Both fields must be set in the URL or there will be no effect on the settings.

Example Usage

https://app.uniswap.org/#/swap?exactField=input&exactAmount=10&inputCurrency=0x0F5D2fB29fb7d3CFeE444a200298f468908cC942

Pool Page

The Pool page is made up of 2 subroutes: add, remove.

Add Liquidity

ParameterTypeDescription
Token0addressPool to withdraw liquidity from. (Must be an ERC20 address with an existing token)
Token1addressPool to withdraw liquidity from. (Must be an ERC20 address with an existing token)

Example Usage

https://app.uniswap.org/#/add/0x6B175474E89094C44Da98b954EedeAC495271d0F-0xdAC17F958D2ee523a2206206994597C13D831ec7

Remove Liquidity

ParameterTypeDescription
Token0addressPool to withdraw liquidity from. (Must be an ERC20 address with an existing token)
Token1addressPool to withdraw liquidity from. (Must be an ERC20 address with an existing token)

Dash seperated.

Example Usage

https://app.uniswap.org/#/remove/0x6B175474E89094C44Da98b954EedeAC495271d0F-0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2