Skip to main content

Documentation 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.

USEFUL MINT INFORMATION
  • Token Metadata like name, symbol, icon to display token information to users
  • Organic Score, Holder count, Market cap, etc can be useful to help make a better trading decision
  • And much more!
Do note that the response is subject to changes as we continue to improve.Refer to Tokens API V2 Reference for full schema.

​
Query by Mint

The Tokens API V2 provides an endpoint to search tokens in the background for you and returns you the search results, along with the mint information. This is useful in most user applications, as users need to choose which tokens they want to swap. This also provides a seamless developer experience as integrating this allows us to handle and abstract the token search mechanism, allowing you to focus on other user features.
SEARCH
  • Search for a token and its information by its symbol, name or mint address.
  • Comma-separate to search for multiple.
  • Limit to 100 mint addresses in query.
  • Default to 20 mints in response when searching via symbol or name.
const searchResponse = await (
  await fetch(`https://api.jup.ag/tokens/v2/search?query=So11111111111111111111111111111111111111112`,
    {
      headers: {
        'x-api-key': 'your-api-key',
      },
    }
  )
).json();

​
Query by Tag

The Tokens API V2 provides an endpoint to query by tags. This is useful to help users distinguish between verified vs non-verified or specific groups of tokens like liquid-staked tokens (LSTs) or tokenized stocks.
TAGS
  • Supported tags: lst, verified, stocks.
  • stocks returns tokenized equities (e.g. Ondo, Remora).
  • Note that this will return the entire array of existing mints that belongs to the tag.
const tagResponse = await (
  await fetch(`https://api.jup.ag/tokens/v2/tag?query=verified`,
    {
      headers: {
        'x-api-key': 'your-api-key',
      },
    }
  )
).json();

​
Get Category

The Tokens API V2 provides an endpoint to get mints and their mint information by categories. These categories are useful for identifying tokens in specific trading scenarios, providing users with more information to trade with.
CATEGORY
  • Only toporganicscore, toptraded or toptrending category.
  • Added query by interval for more accuracy, using 5m, 1h, 6h, 24h.
  • The result filters out generic top tokens like SOL, USDC, etc (since those tokens are likely always top of the categories).
  • Default to 50 mints in response (use limit to increase or decrease number of results).
const categoryResponse = await (
  await fetch(`https://api.jup.ag/tokens/v2/toporganicscore/5m?limit=100`,
    {
      headers: {
        'x-api-key': 'your-api-key',
      },
    }
  )
).json();

​
Get Recent

The Tokens API V2 provides an endpoint to get mints and their mint information by their recency. This is helpful to display to users a list of tokens that just had their first pool created, providing more information to trade with.
RECENT
  • Do note that the definition of RECENT is the token’s first pool creation time (and not token’s mint/creation timestamp).
  • Default to 30 mints in response.
const recentResponse = await (
  await fetch(`https://api.jup.ag/tokens/v2/recent`,
    {
      headers: {
        'x-api-key': 'your-api-key',
      },
    }
  )
).json();

​
Example Response

All endpoints will return an array of mints, along with their information. Successful example response: 
[
  {
    id: 'So11111111111111111111111111111111111111112',
    name: 'Wrapped SOL',
    symbol: 'SOL',
    icon: 'https://raw.githubusercontent.com/solana-labs/token-list/main/assets/mainnet/So11111111111111111111111111111111111111112/logo.png',
    decimals: 9,
    circSupply: 531207433.3986673,
    totalSupply: 603724547.3627878,
    tokenProgram: 'TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA',
    firstPool: {
      id: '58oQChx4yWmvKdwLLZzBi4ChoCc2fqCUWBkwMihLYQo2',
      createdAt: '2021-03-29T10:05:48Z'
    },
    holderCount: 2342610,
    audit: {
      mintAuthorityDisabled: true,
      freezeAuthorityDisabled: true,
      topHoldersPercentage: 1.2422471238911812
    },
    organicScore: 98.92390784896082,
    organicScoreLabel: 'high',
    isVerified: true,
    tags: [ 'community', 'strict', 'verified' ],
    fdv: 87824499429.22047,
    mcap: 77275352037.79674,
    usdPrice: 145.47114211747515,
    priceBlockId: 349038717,
    liquidity: 89970631.83880953,
    stats5m: {
      priceChange: 0.021175445311831707,
      liquidityChange: -0.01230267453174984,
      volumeChange: 4.855149318222242,
      buyVolume: 14644327.188370818,
      sellVolume: 14743625.023908526,
      buyOrganicVolume: 269570.2345543641,
      sellOrganicVolume: 204114.37436445671,
      numBuys: 49281,
      numSells: 54483,
      numTraders: 18155,
      numOrganicBuyers: 981,
      numNetBuyers: 3503
    },
    stats1h: {
      priceChange: -0.145099593531635,
      liquidityChange: -0.13450589635262783,
      volumeChange: -15.928930753985316,
      buyVolume: 171520842.22567528,
      sellVolume: 174057197.5207193,
      buyOrganicVolume: 3099405.8562825476,
      sellOrganicVolume: 2975660.0383528043,
      numBuys: 586069,
      numSells: 649275,
      numTraders: 78145,
      numOrganicBuyers: 2716,
      numNetBuyers: 14442
    },
    stats6h: {
      priceChange: 0.3790495974473589,
      liquidityChange: 0.1659230330014905,
      volumeChange: 14.571340846647542,
      buyVolume: 1084625651.9256022,
      sellVolume: 1094488293.656417,
      buyOrganicVolume: 31145072.655369382,
      sellOrganicVolume: 31647431.25353508,
      numBuys: 3789847,
      numSells: 4363909,
      numTraders: 272131,
      numOrganicBuyers: 10849,
      numNetBuyers: 37155
    },
    stats24h: {
      priceChange: 1.5076363979360274,
      liquidityChange: 2.417364079880319,
      volumeChange: -2.1516094834673254,
      buyVolume: 4273248565.256824,
      sellVolume: 4306065610.69747,
      buyOrganicVolume: 109007133.8196669,
      sellOrganicVolume: 118085567.17983335,
      numBuys: 15125444,
      numSells: 17582713,
      numTraders: 754618,
      numOrganicBuyers: 28590,
      numNetBuyers: 80961
    },
    updatedAt: '2025-06-25T05:02:21.034234634Z'
  }
]