diff --git a/README.md b/README.md
index 7c37005..6e7d6a9 100644
--- a/README.md
+++ b/README.md
@@ -56,6 +56,23 @@ for outcome, points in books["data"].items():
 client.close()
 ```
 
+`markets["data"]` is a list of market objects. Each item includes more fields (`public_id`, `volume`, `event_slug`, …); the essentials look like:
+
+```json
+[
+    {
+        "slug": "will-bitcoin-hit-150k-in-2026",
+        "question": "Will Bitcoin hit $150k in 2026?",
+        "status": "active"
+    },
+    {
+        "slug": "fed-rate-cut-september-2026",
+        "question": "Will the Fed cut rates in September 2026?",
+        "status": "active"
+    }
+]
+```
+
 Context manager usage:
 
 ```python