To maintain a uniform developer experience for all users of the Bluefin Pro API, there are different rate limits on requests for several endpoints

Please make use of the Websockets API if you need real-time data.

🚧
Rate limits are subject to change
All rate limits are subject to change in the future to help ensure a balance between demand and reliability.

Rate Limits

Limits are enforced by IP Address for public endpoints, and by both IP Address and Account for private endpoints:

auth.api.sui-prod.bluefin.io: 30 RPM (just to get a token).
api.sui-prod.bluefin.io: 300 RPM (All pro services except trading gateway and ws streams)
stream.api.sui-prod.bluefin.io: 50 RPM (Websocket streams)
trade.api.sui-prod.bluefin.io: 500 RPM

Requests that exceed the rate limits will receive a HTTP response status code 429 along with error code: 1015 in the error message.

Clients must adapt to the rate limits by managing HTTP 429 responses and honoring the Retry-After response header value, expressed as a decimal number of seconds. By waiting this specified minimum duration, subsequent requests should not be subject to rate limiting. The Retry-After value is set to 60 seconds by default.

An alternative approach to comply with rate limits is to reduce the pace of upcoming requests. This can often be achieved by utilizing one or multiple queues for pending requests, which can be processed by sending requests as long as Bluefin does not return an HTTP 429 response.

High Frequency Trading or Market Making partners known to Bluefin can request higher rate limits on their account.