How does the rate limiting on the /stream endpoint work?



How does the rate limiting on the /stream REST endpoint work? We keep on getting responses like the following…

HTTP/1.1 400 Bad RequestServer: nginx/0.8.55Date: Tue, 02 Jul 2013 15:57:49GMT
Content-Type: application/json
Transfer-Encoding: chunkedConnection:closeX-API-Version: 1P3P: CP="CAO PSA"
X-RateLimit-Limit: 10000
X-RateLimit-Remaining: 9993
X-RateLimit-Cost: 1
{“error”:“This stream has been rate-limited. Use the live stream instead of the buffered stream”}

There’s plenty of RateLimit-Remaining, yet we’re getting rate limited?




This "rate limit" is a restriction on the number of interactions received through the /stream endpoint. This endpoint is not intended for use with high throughput (higher than 20 interactions per second) streams. We have the Streaming API and Push for higher volume (and production) uses. See here for more information about /stream REST endpoint.