Solana Price API

• Prices come from the last onchain swap of each token, anchored on a small set of oracle-priced tokens such as SOL, and pass liquidity, holder and trading-activity heuristics before they are returned.
• Each price carries the Solana blockId it was computed at, the token decimals and the 24-hour change.
• One API key covers every Jupiter API, and the endpoint answers without a key for testing.

​

Quick start

curl "https://api.jup.ag/price/v3?ids=So11111111111111111111111111111111111111112"

{
  "So11111111111111111111111111111111111111112": {
    "usdPrice": 117.940701034589,
    "blockId": 454185009,
    "decimals": 9,
    "priceChange24h": -1.281584448758467,
    "liquidity": 981211365.6060404,
    "createdAt": "2024-06-05T08:55:25.527Z"
  }
}

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

​

Where price data comes from

• Asset origin and launch method
• Market liquidity metrics
• Market behaviour patterns
• Holder distribution statistics
• Trading activity indicators
• Organic Score

​

Pricing challenges on Solana

​

Price response

• 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.
• The priceChange24h is the 24-hour price change as a percentage (e.g. 1.29 means +1.29%, -3.47 means -3.47%), not a 0-1 fraction.
• The liquidity is the total liquidity in USD across all pools, and createdAt is when the token was created (a fixed date for tokens that predate the API, like SOL and USDC).

{
  "JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN": {
    "usdPrice": 0.4056018512541055,
    "blockId": 348004026,
    "decimals": 6,
    "priceChange24h": 0.5292887924920519
  },
  "So11111111111111111111111111111111111111112": {
    "usdPrice": 147.4789340738336,
    "blockId": 348004023,
    "decimals": 9,
    "priceChange24h": 1.2907622140620008
  }
}

​

Limitations

• You can query up to 50 ids at once.

const ids = [
  'So11111111111111111111111111111111111111112',
  'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v',
];

const price = await (
  await fetch(`https://api.jup.ag/price/v3?ids=${ids.join(',')}`, {
    headers: { 'x-api-key': 'your-api-key' },
  })
).json();

const missing = ids.filter((id) => !(id in price));

• It has not been traded recently, in the last 7 days.
• The heuristics flag the price as unreliable, where certain combinations of factors indicate potential issues with price reliability or market health.

• V3 returns a single accurate price per token, eliminating ambiguity from V2’s multiple price fields that led to inconsistent interpretations across platforms.
• Price accuracy is maintained through heuristics that eliminate outliers, providing one stable price source.
• If you need the additional data that V2 provided, use a quote from the Swap API (GET /order without taker) to derive equivalent values (see how Price API V2 pricing was derived).

​

Common use cases

​

FAQ