Rate Limits

Every guild's token(s) share a flat limit of 20 requests per second, enforced per guild (not per individual token — if a guild has multiple tokens, they share one limit).

Exceeding the limit returns 429 with error.code: "RATE_LIMITED". Standard RateLimit-* headers are included on every response so you can track your remaining budget without waiting for a 429.

One route has an additional, tighter limit on top of the flat 20/s ceiling:

• GET /items full-list calls only, i.e. without an item query param, is limited to 1 request per 5 seconds per guild, to protect against accidental full-catalog polling. A single-item lookup via ?item=NAME is exempt from this stricter limit.