diff --git a/README.md b/README.md
index 2ef80bb5..94759130 100644
--- a/README.md
+++ b/README.md
@@ -8,3 +8,11 @@ Install requirements.txt in a virtual environment of your choice and execute mai
 pip install -r requirements.txt
 python main.py
 ```
+## Project Structure
+
+- `examples/` – simple usage examples of the Kalshi API  
+- `kalshi/` – core client logic  
+- `tests/` – basic test cases  
+- `requirements.txt` – Python dependencies
+
+This overview helps new users quickly understand the repository layout.