Rate Limit Exceeded  [Go SDK]

When a single user makes too many requests to Horizon in a one hour time frame, Horizon returns a rate_limit_exceeded error. By default, Horizon allows 3600 requests per hour – an average of one request per second. This is analogous to a HTTP 429 Error.

If you are encountering this error, please reduce your request speed. Here are some strategies for doing so:

• For collection endpoints, try specifying larger page sizes.
• Try streaming responses to watch for new data instead of pulling data every time.
• Cache immutable data, such as transaction details, locally.

See the Rate Limiting Guide for more info.

Attributes

As with all errors Horizon returns, rate_limit_exceeded follows the Problem Details for HTTP APIs draft specification guide and thus has the following attributes:

Example

{
  "type": "https://stellar.org/horizon-errors/rate_limit_exceeded",
  "title": "Rate Limit Exceeded",
  "status": 429,
  "details": "The rate limit for the requesting IP address is over its alloted limit.  The allowed limit and requests left per time period are communicated to clients via the http response headers 'X-RateLimit-*' headers."
}