System Limits

Overview

The Trading API uses a comprehensive rate limiting system that tracks both IP addresses and wallet addresses through a time-weighted point system. Each API call consumes a predetermined number of points from your available quota within a rolling time window. Point consumption varies by endpoint, with some routes consuming different amounts and others consuming no points at all.

Current Limits and Shared Quotas

The system currently allows 100,000 points per 5-minute window. HTTP API calls and WebSocket connections share different point pools, with WebSocket streams consuming points upon connection and subscription. We strongly encourage integrators to use websockets for data retrieval as polling HTTP endpoints will incur more points.

The team will modify rate limits during mainnet alpha based on exchange traffic.

RateLimit-*, Retry-After Headers

All rate-limited HTTP API endpoints return the following headers to provide insight into your remaining points:

RateLimit-Limit: <total points allowed in the time window>
RateLimit-Remaining: <points remaining in the current time window>
RateLimit-Reset: <seconds until rate limit resets>
Retry-After: <seconds until rate limit resets (only when rate limited)>

• Retry-After/RateLimit-Reset: Indicates the number of seconds until the rate limit window resets. If you've exceeded your rate limit, this header tells you how long to wait before making additional requests.

• RateLimit-Limit: Shows the total number of points available in your current time window (1 million points by default).

• RateLimit-Remaining: Displays the number of points you have remaining in the current time window. This decreases with each API call according to the point cost of the specific endpoint.

Points

Each operation consumes rate limit units proportional to its computational cost: 1, 3, 5, 10, 50, or 100.

• 1: Minimal impact endpoints (simple reads, submit/cancels)

• 3: Light impact endpoints (paginated reads)

• 5: Moderate impact endpoints (moderately complex reads)

• 10: Elevated average impactful endpoints (moderately complex pagination)

• 50: High impact endpoints (archival and complex pagination)

• 100: Heavy high impact endpoints (infrequently used or computationally expensive)

All endpoints are classified into one of these categories to provide a straightforward understanding of their relative impact on your rate limit quota.

Points per endpoint may change at any time and the notes here may not always be the most up to date.

All websocket connections consume 10 points per connection and 5 point to subscribe to a message stream.

Account Limits

• Maximum 50 open positions per subaccount (for efficient onchain verification)

• No limit on number of subaccounts per trader

• 10 withdrawals per day

Order Limits

• A maximum of 200 orders