FAQ

Didn't find an answer? Join the community Discord to get support

What is Uniswap?

Uniswap is a protocol for exchanging ERC-20 tokens on Ethereum. It eliminates trusted intermediaries and unnecessary forms of rent extraction, allowing for fast, efficient trading. Where it makes tradeoffs decentralization, censorship resistance, and security are prioritized. Uniswap is open-source software licensed under GPL.

If you want to understand more about Uniswap check out the docs.

How does Uniswap work?

Uniswap is an automated liquidity protocol. In practical terms this means there are template smart contracts that define a standard way to make liquidity pools and corresponding markets that are compatible with eachother. There is no orderbook, no centralized party and no central facilitator of trade. Each pool is defined by a smart contract that includes a few functions to enable swapping tokens, adding liquidity and more. At its core each pool uses the function x*y=k to maintain a curve along which trades can happen.

For a more in depth description. Check out the How Uniswap works from the documentation.

How are prices determined?

Prices are determined by the amount of each token in a pool. The smart contract maintains a constant using the following function: x*y=k. In this case x = token0, y = token1, k = constant. For each trade a certain amount of tokens are removed from the pool for an amount of the other token. To maintain k, the balances held by the smart contract are adjusted during the execution of the trade, therefore changing the price.

Why is my swap failing or stuck?

You might be trying to swap a fee on transfer or deflationary token. If so, you have to increase your allowed slippage to account for the fee taken during the swap. Click on the gear for settings and adjust Slippage tolerance accordingly.

Otherwise if your transaction is taking forever or stuck pending the gas included might be too low and the transaction will not be processed. You probably need to speed up or cancel the transaction in you wallet.

Why is my approve stuck?

If you speed up an approve, Uniswap can’t detect the new transaction. Open your wallet in the interface and click “clear all” then try refreshing the page.

How do I find X token?

If you can’t find a token in the default list, find the token address using etherscan and paste that address into the search field.

How do I add a logo for a token?

Uniswap pulls from the trustwallet asset repository on github. https://github.com/trustwallet/assets Add your token icon to that repo and it will appear on the frontend and on info.

How can I add a token to Uniswap?

Uniswap is compatible with any ERC-20 token in the ethereum ecosystem. If you want your project to be searchable in their interface you should seek to be added to a reputable token list or share a link to your token using query parameters. Once loaded via link, the token will be added to their interface.

Another option is to open a request using github issues.

The uniswap team makes no guarantees or provides any timeline. Nor will the team ever charge or request funds. We’ve added many UX features to make it easier to share a new token with communities like local storage support and custom linking. Please make use of them.

Why does my transaction cost X?

Ethereum requires gas to execute each transaction. You can also check ETH gas station for the current prices required to complete transactions. Creating a Uniswap pool is a slightly costlier transaction because you are executing a more complex smart contract. Read more about how gas works in ethereum.

How can I see my liquidity provider fees?

There are many community built tools like https://www.uniswaproi.com/, https://www.zapper.fi/dashboard and https://zerion.io/. Uniswap provides no guarantees the information on these sites is correct.

I updated my token via a proxy contract, but the Uniswap information page is showing the old symbol / name!

Info.uniswap reads the details of new tokens when they’re added to the subgraph. There may be some circumstances where an old symbol or name isn’t updated if the token was updated with a proxy contract. A guide to fix this yourself is forthcoming, in the meantime, reach out with the details on our developer discord.

Uniswap tools and resources

https://github.com/Uniswap/universe