Nitpick, in your 'Rate Limiting' section:

Avoid blasting too much events to a single endpoint at once with flexible rate limiting controls

I would write this as:

Avoid blasting too many events