diff --git a/docs/API_RATE_LIMITS.md b/docs/API_RATE_LIMITS.md
new file mode 100644
index 00000000..f7349519
--- /dev/null
+++ b/docs/API_RATE_LIMITS.md
@@ -0,0 +1,17 @@
+# API rate limits
+
+Kalshi enforces rate limits on its API to ensure fair usage.
+
+## Demo environment
+
+- Request limit: 60 requests per minute
+- Burst: 20 requests per second
+- Consequence: Exceeding the limit returns HTTP 429
+
+## Production environment
+
+- Request limit: 180 requests per minute
+- Burst: 60 requests per second
+- Rate limits may vary by account tier
+
+If you encounter 429 responses, implement exponential backoff and respect the `Retry-After` header.