@@ -6,16 +6,22 @@ uniswap-python provides a basic command line interface named ``unipy``, to let y
 Examples
 --------
 
+**Note:** uniswap-python contains a small database of token contract addresses for convenience. You can always provide a contract address in place of a shorthand, and need to do so for all tokens not in the bundled database, or if you're not on mainnet.
+
 .. code:: shell
 
     # Get price for 1 WETH quoted in DAI
-    $ unipy price 0x6b175474e89094c44da98b954eedeac495271d0f 0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2
+    $ unipy price WETH DAI
     3350.883387688622
 
-    # Get price for 1 WETH quoted in DAI, skip normalization
-    $ unipy price --raw 0x6b175474e89094c44da98b954eedeac495271d0f 0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2
+    # Get price for 1 WETH quoted in DAI, skip decimal normalization
+    $ unipy price --raw WETH DAI
     3350883387688622003541
 
+    # Get price for 1 WETH quoted in USDT
+    $ unipy price WETH 0xdac17f958d2ee523a2206206994597c13d831ec7
+    3348.128969
+
     # Get token metadata from its ERC20 contract
     $ unipy token 0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2
     {'name': 'Wrapped Ether', 'symbol': 'WETH', 'decimals': 18}
 
@@ -39,24 +39,24 @@ def main(verbose: bool) -> None:
 @click.option(
     "--raw",
     is_flag=True,
-    help="Don't normalize the quoted price to the input tokens's decimals",
+    help="Don't normalize the quoted price to the output token's decimals",
 )
 @click.option(
     "--quantity",
-    help="Quantity of output tokens to get price of. Falls back to one full unit of the output by default (10**18 for WETH, for example).",
+    help="Quantity of output tokens to get price of. Falls back to one full unit of the input token by default (10**18 for WETH, for example).",
 )
 def price(
     token_in: AddressLike, token_out: AddressLike, raw: bool, quantity: int = None
 ) -> None:
-    """Returns the price of ``quantity`` tokens of ``token_out`` quoted in ``token_in``."""
+    """Returns the price of ``quantity`` tokens of ``token_in`` quoted in ``token_out``."""
     uni = Uniswap(None, None, version=2)
     if quantity is None:
-        quantity = 10 ** uni.get_token(token_out)["decimals"]
-    price = uni.get_token_token_output_price(token_in, token_out, qty=quantity)
+        quantity = 10 ** uni.get_token(token_in)["decimals"]
+    price = uni.get_token_token_input_price(token_in, token_out, qty=quantity)
     if raw:
         print(price)
     else:
-        decimals = uni.get_token(token_in)["decimals"]
+        decimals = uni.get_token(token_out)["decimals"]
         print(price / 10 ** decimals)