Skip to content

Observe rate limits

XMTP enforces separate rate limits for read and write operations per client per rolling 5-minute window:

  • Read operations: 20,000 requests per 5-minute window
  • Write operations: 3,000 messages published per 5-minute window

When you reach either rate limit, your API calls will be rejected with a 429 (Too Many Requests) error.

Read operations include actions like:

  • Fetching conversations
  • Retrieving messages
  • Getting inbox state
  • Listing installations

Write operations include actions like:

  • Sending chat messages
  • Adding and removing wallets
  • Adding and revoking installations
  • Adding and removing group members
  • Updating group metadata