Rate Limiting

There is a default rate limit of 10 calls in every 10 second window

If you go over this, we will return a 420 HTTP Response Code with the payload below. You'll need to wait until you're able to make a call again.

{
	error: "You have surpassed your rate limit. Please wait until the X-RateLimit-Reset time before making another call. This time is in the X-RateLimit-Reset http response header and is in epoch time."
}

All of our responses will return these fields in the HTTP response header:

X-RateLimit-Reset: The epoch time the rate limit will reset.
X-RateLimit-Limit: The maximum number of API calls in the 10 second timeframe.
X-RateLimit-Remaining: The number of API calls left in the 10 second timeframe.
X-RateLimit-Month-Remaining: The number of calls remaining for the current month

You can view these headers in the interactive docs if you run a sample request and click the "Metadata" tab.