OstiumBuilder Service
Resources

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.

Errors

Error envelopes and error codes.

AI Spec (Compact)

Token-efficient API context for LLMs.

On this page

HTTP Rate LimitsConfigurationWebSocket Trade Rate Limits