Skip to main content

API Responses

In this section, you can find the list of responses that can be returned by the Jupiter API.

API Usage

Hostnames

  • For paid tiers with API Keys, use api.jup.ag
  • For free tier, use lite-api.jup.ag (NO API Key required)

API Key

Simply add the API Key in the x-api-key field in the Headers.

headers: {
    'Content-Type': 'application/json',
    'x-api-key': '' // enter api key here
},
Program Errors

For more information on error codes from programs, see the Swap API - Common Errors.

Common CodesDescriptionDebug
200GoodSuccess!
400Bad RequestLikely a problem with the request, check the request parameters, syntax, etc.
401UnauthorizedLikely a problem with the API key, check if the API key is correct.
404Not FoundLikely a broken or invalid endpoint.
429Rate LimitedYou are being rate limited. Either slow down requests, reduce bursts, or upgrade your plan.
500Internal Server ErrorPlease reach out in Discord.
502Bad GatewayPlease reach out in Discord.
503Service UnavailablePlease reach out in Discord.
504Gateway TimeoutPlease reach out in Discord.