Rate Limit Exceeded  [Go SDK]

When a single user makes too many requests to Frontier in a one hour time frame, Frontier returns a rate_limit_exceeded error. By default, Frontier 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 Frontier returns, rate_limit_exceeded follows the Problem Details for HTTP APIs draft specification guide and thus has the following attributes:

Attribute Type Description
type URL The identifier for the error. This is a URL that can be visited in the browser.
title String A short title describing the error.
status Number An HTTP status code that maps to the error.
detail String A more detailed description of the error.

Example

{
  "type": "https://digitalbits.org/frontier-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."
}

Edit this doc in GitHub

THE FUTURE OF LOYALTY STARTS HERE

Stay up to date on the latest happenings at DigitalBits. Get the latest news.