Rate limits

Recommended client behavior

• Use exponential backoff after 429 responses
• Add jitter to avoid synchronized retries
• Cache read-heavy responses where possible
• Avoid unnecessary polling; prefer event-driven flows when available

Backoff template

attempt 1: wait 500ms
attempt 2: wait 1000ms
attempt 3: wait 2000ms
attempt 4: wait 4000ms (+ random jitter)