Skip to main content

Ecosystem Master Token List

danger

The current version of Token API will be sunsetted/deprecated, as we are currently working on improvements for it over the next few weeks.

API Endpoints

GET tokens by tag

https://tokens.jup.ag/tokens?tags=verified

Convenience Tags

For most people, these 2 tags are all you need. All tokens would either be verified or unknown.

ParameterDescription
verifiedTokens that we display as verified on jup.ag. Today, this is a superset consisting of tokens tagged “community” and “lst”. You can use this setting to automatically receive jupiter’s settings when we update our allowlist.
unknownUntagged tokens that we display a warning on on jup.ag.

Other Tags Available

ParameterDescription
communityTokens that are verified by the Jupiter community. To get a community tag for your project, go to https://catdetlist.jup.ag
strictTokens that were validated previously in the strict-list repo. This repo will be deprecated, please use the community site to get a community tag going forward.
lstSanctum’s list from their repo which we automatically pull: https://github.com/igneous-labs/sanctum-lst-list/blob/master/sanctum-lst-list.toml
birdeye-trendingTop 100 trending tokens from birdeye: https://birdeye.so/find-gems?chain=solana
cloneTokens from Clone protocol, from their repo: https://raw.githubusercontent.com/Clone-Protocol/token-list/main/token_mints.csv
pumpTokens that graduated from pump, from their API
Usage: You can pass in a single tag or multiple:

- Single tag: https://tokens.jup.ag/tokens?tags=verified
- Multiple tags: https://tokens.jup.ag/tokens?tags=lst,community
GET token by mint

https://tokens.jup.ag/token/So11111111111111111111111111111111111111112

ParameterDescription
mint_addressPass the mint address of the token you want like this https://tokens.jup.ag/token/So11111111111111111111111111111111111111112

We only support filtering for 1 token at a time right now.

Example response:

{"address":"jupSoLaHXQiZZTSfEWMTRRgpnyFm8f6sZdosWBjx93v","name":"Jupiter Staked SOL","symbol":"JupSOL","decimals":9,"logoURI":"https://static.jup.ag/jupSOL/icon.png","tags":["community","strict","lst"],"daily_volume":2228947.6686637774,"freeze_authority":null,"mint_authority":"EMjuABxELpYWYEwjkKmQKBNCwdaFAy4QYAs6W9bDQDNw"},
GET tradable tokens only

https://tokens.jup.ag/tokens_with_markets

Get all tradable tokens that meet jup.ag’s routing and liquidity threshold. This is a large response, please consider fetching tokens by tags instead

Usage notes:

  • There is a rate limit of 30 requests per minute. Please pass a referer / origin in your request header
  • Enhanced metadata: We added daily volume, freeze authority and mint authority for your convenience. More fields will be available over time such as coingecko id.
  • If you see a token.jup.ag (without the s, the new one is tokens.jup.ag) in your codebase, that's our deprecated old API.

Resources