Skip to main content

​
Overview

This guide will help you migrate from lite-api.jup.ag to api.jup.ag. The migration is straightforward - only the base URL and API key requirement changes.

​
What Changed?

We will be stopping support for API requests with no API key, hence you are required to migrate to api.jup.ag and use with an API key.
Before (Deprecated)After (Current)
https://lite-api.jup.ag/...https://api.jup.ag/...
No API key requiredAPI key required (free tier available)
Free tierFree tier (with API key)

​
Migration Steps

​
Step 1: Generate API Key

  1. Visit portal.jup.ag
  2. Connect via email
  3. Generate an API key (free tier available)
  4. Copy your API key
The free tier provides 60 requests per minute.

​
Step 2: Update Your Base URL

Replace all instances of lite-api.jup.ag with api.jup.ag: 
- const baseUrl = 'https://lite-api.jup.ag';
+ const baseUrl = 'https://api.jup.ag';

​
Step 3: Add API Key Header

To use your API key, pass in via header as x-api-key: 
// Before (deprecated)
const response = await fetch('https://lite-api.jup.ag/ultra/v1/order?...');

// After (current)
const response = await fetch('https://api.jup.ag/ultra/v1/order?...', {
  headers: {
    'x-api-key': 'your-api-key-here',
  },
});

​
Migration Checklist

  • Generate API key from portal.jup.ag
  • Update all lite-api.jup.ag URLs to api.jup.ag
  • Add x-api-key header to all API requests
  • Test API calls with new endpoint
  • Update environment variables/config files
  • Update documentation/comments in code

​
Endpoint Mapping

All endpoints remain the same, only the base URL changes:
ServiceOld EndpointNew Endpoint
Ultra APIlite-api.jup.ag/ultra/v1/...api.jup.ag/ultra/v1/...
Swap APIlite-api.jup.ag/swap/v1/...api.jup.ag/swap/v1/...
Price APIlite-api.jup.ag/price/v2/...api.jup.ag/price/v2/...
Tokens APIlite-api.jup.ag/tokens/v1/...api.jup.ag/tokens/v1/...
Trigger APIlite-api.jup.ag/trigger/v1/...api.jup.ag/trigger/v1/...
Recurring APIlite-api.jup.ag/recurring/v1/...api.jup.ag/recurring/v1/...
Send APIlite-api.jup.ag/send/v1/...api.jup.ag/send/v1/...
Studio APIlite-api.jup.ag/studio/v1/...api.jup.ag/studio/v1/...
Lend APIlite-api.jup.ag/lend/v1/...api.jup.ag/lend/v1/...

​
Common Issues

Problem: Getting 401 errors after migration
Solution: Make sure you are including the x-api-key header in all requests.
Problem: Hitting rate limits
Solution: Free tier provides 60 requests per minute. Consider upgrading to Pro tier for higher limits. Refer to Rate Limit for more details.

​
Need Help?