Rate limits

Limits are per key, so one busy tool can’t use up another tool’s allowance.

What	Limit
Requests	60 burst, refilling at 1 per second
Commands	5 burst, refilling at 1 every 3 seconds (20 a minute)
Commands per server	10 at once, refilling to 30 a minute, across all keys
Bad keys per IP	20 a minute

Every response carries the read limit:

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 57
X-RateLimit-Reset: 3

X-RateLimit-Reset is the number of seconds until the bucket is full again. Going over returns 429 with a Retry-After header in seconds. Wait that long before trying again.

{ "error": { "code": "rate_limited", "message": "You're being rate limited. Wait for Retry-After seconds." } }

Polling every 5 to 10 seconds is plenty: the game sends fresh data about every 10 seconds. For events, use webhooks or the events feed with a cursor instead of re-reading logs.

Start here

Basics

Features

Integrations

Server owners

More