OstiumBuilder Service
Getting Started

Rate Limits

HTTP and WebSocket rate limiting behavior.

Alpha Version

The Ostium Builder Service is in Alpha. API endpoints, specifications, and builder URLs may change without notice. Use with caution in production environments.

HTTP Rate Limits

Requests are rate-limited per IP with response headers:

  • X-RateLimit-Limit
  • X-RateLimit-Remaining
  • X-RateLimit-Reset (seconds until reset)

When exceeded, the response includes:

  • Retry-After header
  • errorCode: RATE_LIMIT_EXCEEDED
  • details.limit, details.windowMs, details.retryAfter

Configuration

Server defaults can be adjusted with environment variables:

  • RATE_LIMIT_MAX_REQUESTS (default: 100)
  • RATE_LIMIT_WINDOW_MS (default: 60000)
  • RATE_LIMIT_ENABLED (default: true)
  • RATE_LIMIT_WHITELIST (comma-separated IPs)

WebSocket Trade Rate Limits

Trade action WebSocket connections are limited to 100 messages per minute per connection.

Data Types & Formatting

Understanding data types, precision, and formatting requirements.

Error Handling

Error envelopes and error codes.

On this page

HTTP Rate LimitsConfigurationWebSocket Trade Rate Limits