Ultra Swap uses dynamic rate limiting that scales with your executed swap volume. The base quota is 50 requests per 10-second sliding window, and additional quota is added based on your rolling 24-hour volume fromDocumentation Index
Fetch the complete documentation index at: https://dev.jup.ag/docs/llms.txt
Use this file to discover all available pages before exploring further.
/execute. A free API key from Portal is required.
Overview
| Property | Dynamic |
|---|---|
| Base URL | https://api.jup.ag/ultra/ |
| Cost | Free to use, but Ultra Swap incurs swap fees |
| API Key | Required |
| Requests Per Minute | Base Quota + Added Quota |
API Key Rules
The Ultra Swap API requires an API key to be used and can be generated via Portal.- It is required to be used for the Dynamic Rate Limit.
- The API Key is free to generate and is universal, the API Key will work for all APIs.
- Upgrading to a Pro plan only applies to other APIs, does not work with Ultra Swap API.
Read about Developer Platform Rate Limits
How Dynamic Rate Limit Works
Every 10 minutes- The system aggregates your swap volume from
/executeon Ultra Swap for the current rolling day (volume of (current timestamp - 1 day) up to present). - After which, the Added Quota will update, which will be added on top of the Base Quota.
| Swap Volume | Requests Per Period | Sliding Window Period |
|---|---|---|
| $0 | 50 Base + 0 Added = 50 | 10 seconds |
| $10,000 | 50 Base + 1 Added = 51 | 10 seconds |
| $100,000 | 50 Base + 11 Added = 61 | 10 seconds |
| $1,000,000 | 50 Base + 115 Added = 165 | 10 seconds |
Managing Rate Limits
If you receive a 429 response, you should:- Implement exponential backoff in your retry logic
- Wait for sliding window to allow for more requests
- Scale your Ultra Swap usage to unlock higher limits or reach out to us in Discord.