Repository files navigation

The unofficial Python client forUniswap.

Documentation is available athttps://uniswap-python.com/

The authors are in no way affiliated with or funded by Uniswap, uniswap.io, or any subsidiaries or affiliates of any of the previously mentioned entities.

• A simple to use Python wrapper for all available contract functions and variables
• A basic CLI to get prices and token metadata
• Simple parsing of data returned from the Uniswap contract

This README is documentation on the syntax of the python client presented in this repository. See function docstrings for full syntax details.

This library attempts to present a clean interface to Uniswap, but in order to use it to its full potential, you must familiarize yourself with the official Uniswap documentation.

• https://docs.uniswap.io/

You may manually install the project or use pip:

pipinstalluniswap-python# orpipinstallgit+git://github.com/shanefontaine/uniswap-python.git

The program expects an environment variables to be set in order to run the program. You can use an Infura node, since the transactions are being signed locally and broadcast as a raw transaction. The environment variable is:

PROVIDER  # HTTP Provider for web3

To modify the gas pricing strategy you need to pass a customWeb3 instance to theUniswap constructor. You can find details for how to configure Web3 gas strategies in theirdocumentation.

Note: These examples are in the process of being moved to thedocs.

TheUniswap class takes several optional parameters, read the code to see which ones are available.

fromuniswapimportUniswapaddress="YOUR ADDRESS"# or "0x0000000000000000000000000000000000000000", if you're not making transactionsprivate_key="YOUR PRIVATE KEY"# or None, if you're not going to make transactionsuniswap_wrapper=Uniswap(address,private_key,version=2)# pass version=2 to use Uniswap v2eth="0x0000000000000000000000000000000000000000"bat="0x0D8775F648430679A709E98d2b0Cb6250d2887EF"dai="0x89d24A6b4CcB1B6fAA2625fE562bDD9a23260359"

Note: These methods assume a certain route for the swap to take, which may not be the optimal route. See#69 for details.

These methods return the price as an integer in the smallest unit of the token. You need to ensure that you know how many decimals the token you're trying to trade uses to get prices in the common decimal format. See#12 for details.

Decimals for common tokens:

• ETH, DAI, and BAT uses 18 decimals (as you can see in code below)
• WBTC uses 8 decimals
• USDC and USDT uses 6 decimals

You can look up the number of decimals used by a particular token by looking up the contract on Etherscan. As an example, here is the one for WBTC:https://etherscan.io/token/0x2260fac5e5542a773aa44fbcfedf7c193bc2c599

• get_eth_token_input_price

# Get the public price for ETH to Token trades with an exact input.uniswap_wrapper.get_eth_token_input_price(bat,1*10**18)uniswap_wrapper.get_eth_token_input_price(dai,5*10**18)

• get_token_eth_input_price

# Get the public price for token to ETH trades with an exact input.uniswap_wrapper.get_token_eth_input_price(bat,1*10**18)uniswap_wrapper.get_token_eth_input_price(dai,5*10**18)

• get_eth_token_output_price

# Get the public price for ETH to Token trades with an exact outputuniswap_wrapper.get_eth_token_output_price(bat,1*10**18)uniswap_wrapper.get_eth_token_output_price(dai,5*10**18)

• get_token_eth_output_price

# Get the public price for token to ETH trades with an exact output.uniswap_wrapper.get_token_eth_output_price(bat,1*10**18)uniswap_wrapper.get_token_eth_output_price(dai,5*10**18)

Note: The same route assumptions and need for handling decimals apply here as those mentioned in the previous section.

• make_trade
  • eth_to_token_input
    • ethToTokenSwapInput
    • ethToTokenTransferInput
  • token_to_eth_input
    • tokenToEthSwapInput
    • tokenToEthTransferInput
  • token_to_token_input
    • tokenToTokenSwapInput
    • tokenToTokenTransferInput

# Make a trade based on the input parametersuniswap_wrapper.make_trade(eth,bat,1*10**18)# calls _eth_to_token_inputuniswap_wrapper.make_trade(bat,eth,1*10**18)# calls _token_to_eth_inputuniswap_wrapper.make_trade(bat,dai,1*10**18)# calls _token_to_token_inputuniswap_wrapper.make_trade(eth,bat,1*10**18,"0x123...")# calls _eth_to_token_input

• make_trade_output
  • eth_to_token_swap_output
    • ethToTokenSwapOutput
    • ethToTokenTransferOutput
  • token_to_eth_swap_output
    • tokenToEthSwapOutput
    • tokenToEthTransferOutput
  • token_to_token_swap_output
    • tokenToTokenSwapOutput
    • tokenToTokenTransferOutput)

# Make a trade where the output qty is known based on the input parametersuniswap_wrapper.make_trade_output(eth,bat,1*10**18)# calls _eth_to_token_swap_outputuniswap_wrapper.make_trade_output(bat,eth,1*10**18)# calls _token_to_eth_swap_outputuniswap_wrapper.make_trade_output(bat,dai,1*10**18,"0x123...")# calls _token_to_token_swap_output

• get_fee_maker

uniswap_wrapper.get_fee_maker()

• get_fee_taker

uniswap_wrapper.get_fee_taker()

• get_ex_eth_balance

# Get the balance of ETH in an exchange contract.uniswap_wrapper.get_ex_eth_balance(bat)

• get_ex_token_balance

# Get the balance of a token in an exchange contract.uniswap_wrapper.get_ex_token_balance(bat)

• get_exchange_rate

# Get the exchange rate of token/ETHuniswap_wrapper.get_exchange_rate(bat)

• add_liquidity

# Add liquidity to the pool.uniswap_wrapper.add_liquidity(bat,1*10**18)

• remove_liquidity

# Remove liquidity from the pool.uniswap_wrapper.remove_liquidity(bat,1*10**18)

Unit tests are under development using the pytest framework. Contributions are welcome!

Test are run on a fork of the main net using ganache-cli. You need to install it withnpm install -g ganache-cli before running tests.

To run the full test suite, in the project directory run:

make test

• Shane Fontaine
• Erik Bjäreholt

• I own some BAT and DAI tokens that are seen in the examples above. These tokens are used only for example purposes and are not meant to be an endorsement. I am not affiliated with BAT, Brave, Basic Attention Token, Brave Browser, DAI, Maker, MakerDAO, or any subsidiaries.

0.4.6

• Bug fix: Update bleach package from 3.1.4 to 3.3.0

0.4.5

• Bug fix: Use .eth instead of .ens

0.4.4

• General: Add new logo for Uniswap V2
• Bug fix: Invalid balance check (#25)
• Bug fix: Fixed error when passing WETH as token

0.4.3

• Allow kwargs inapproved decorator.

0.4.2

• Add note about Uniswap V2 support

0.4.1

• Update changelog for PyPi and clean up

0.4.0

A huge thank youErik Bjäreholt for adding Uniswap V2 support, as well as all changes in this version!

• Added support for Uniswap v2
• Handle arbitrary tokens (by address) using the factory contract
• Switched from setup.py to pyproject.toml/poetry
• Switched from Travis to GitHub Actions
• For CI to work in your repo, you need to set the secret MAINNET_PROVIDER. I use Infura.
• Running tests on a local fork of mainnet using ganache-cli (started as a fixture)
• Fixed tests for make_trade and make_trade_output
• Added type annotations to the entire codebase and check them with mypy in CI
• Formatted entire codebase with black
• Moved stuff around such that the basic import becomes from uniswap import Uniswap (instead of from uniswap.uniswap import UniswapWrapper)
• Fixed misc bugs

0.3.3

• Provide token inputs as addresses instead of names

0.3.2

• Add ability to transfer tokens after a trade
• Add tests for this new functionality

0.3.1

• Add tests for all types of trades

0.3.0

• Add ability to make all types of trades
• Add example to README

0.2.1

• Add liquidity tests

0.2.0

• Add liquidity and ERC20 pool methods

0.1.1

• Major README update

0.1.0

• Add market endpoints
• Add tests for market endpoints