Skip to main content

Price API V3 (Beta)

Price API V3 aims to provide a one source of truth across all Jupiter UIs and integrator platforms. The simplified format allows easy integration while letting Jupiter handle the complexity of ensuring the accuracy of the provided prices.

note
  • Lite URL: https://lite-api.jup.ag/price/v3
  • Pro URL: https://api.jup.ag/price/v3

To upgrade to Pro or understand our rate limiting, please refer to this section.

info

This is in Beta and subject to changes, if you need help please reach out to us in Discord

How Price is Derived​

Price API V3 price tokens by using the last swapped price (across all transactions). The swaps are priced by working outwards from a small set of reliable tokens (like SOL) whose price we get from external oracle sources.

While and also after deriving the last swap price, we also utilize a number of heuristics to ensure the accuracy of the price and eliminate any outliers:

  • Asset origin and launch method
  • Market liquidity metrics
  • Market behaviour patterns
  • Holder distribution statistics
  • Trading activity indicators
  • Market value to liquidity ratios

Get Price​

Simply request via the base URL with the query parameters of your desired mint addresses. You can also comma-separate them to request for multiple prices.

const price = await (
    await fetch(
        'https://lite-api.jup.ag/price/v3?ids=So11111111111111111111111111111111111111112,JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN'
    )
).json();
console.log(JSON.stringify(price, null, 2));

Price Response​

Here is the sample response, notice a few details here:

  • The usdPrice is the only price.
  • The decimals response is helpful to display price information on the UI.
  • The blockId can be used to verify the recency of the price.
{
  "JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN": {
    "usdPrice": 0.4056018512541055,
    "blockId": 348004026,
    "decimals": 6,
    "priceChange24h": 0.5292887924920519
  },
  "So11111111111111111111111111111111111111112": {
    "usdPrice": 147.4789340738336,
    "blockId": 348004023,
    "decimals": 9,
    "priceChange24h": 1.2907622140620008
  }
}

Limitations​

Query limits​

  • You can query up to 50 ids at once.

If the price of a token cannot be found​

  • It is likely that the token has not been traded recently - in the last 7 days.

V2 had more information​

  • Yes V2 had more information, however, we think that it is not the best representation of price and it also caused different interpretations of price across the different platforms.
  • With Price API V3, we are handling the complexities to ensure price accuracy and elimate outliers using the heuristics as mentioned above, so there will only be one stable and accurate price source for all.
  • If you require more information like Price API V2, you can use the /quote endpoint of the Swap API to derive those data (you can refer to this post about how Price API V2 is derived).