diff --git a/README.md b/README.md
index b998273..3a85085 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,18 @@
-# py-defi-sdk
+# Fireblocks Python DeFi SDK
+[![PyPI version](https://badge.fury.io/py/fireblocks-defi-sdk-py.svg)](https://badge.fury.io/py/fireblocks-defi-sdk-py)
+
+The Fireblocks Python DeFi SDK provides an interoperability layer between Fireblocks Smart Contract API and common DeFi libraries.
+For more information on Fireblocks Smart Contract API and automating DeFi workflows on Fireblocks [read here](https://support.fireblocks.io/hc/en-us/articles/360017709160-Fireblocks-Smart-Contract-API).
+
+Please email us at support@fireblocks.com if you have questions or feedback.
+
+## Usage
+### Installation
+`pip3 install fireblocks-defi-sdk-py`
+
+### Requirements
+Python 3.6 or newer
+
+## Code Examples
+* [Basic Example](./examples/basic_example.py)
+* [Trading on Uniswap](./examples/uniswap_example.py)