diff --git a/docs/HTTP_TIMEOUTS.md b/docs/HTTP_TIMEOUTS.md
new file mode 100644
index 00000000..9097b366
--- /dev/null
+++ b/docs/HTTP_TIMEOUTS.md
@@ -0,0 +1,12 @@
+# HTTP Timeouts
+
+Recommended defaults for clients calling CLOB endpoints:
+
+- Connect timeout: 3s
+- Read timeout: 10s
+- Total timeout: 15s (if supported)
+
+Retry guidance:
+- Retry only idempotent requests
+- Use exponential backoff with jitter
+- Cap retries (e.g., 3 attempts)