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 taghttps://tokens.jup.ag/tokens?tags=verified
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.
Parameter | Description |
---|---|
verified | Tokens 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. |
unknown | Untagged tokens that we display a warning on on jup.ag. |
Other Tags Available
Parameter | Description |
---|---|
community | Tokens that are verified by the Jupiter community. To get a community tag for your project, go to https://catdetlist.jup.ag |
strict | Tokens 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. |
lst | Sanctum’s list from their repo which we automatically pull: https://github.com/igneous-labs/sanctum-lst-list/blob/master/sanctum-lst-list.toml |
birdeye-trending | Top 100 trending tokens from birdeye: https://birdeye.so/find-gems?chain=solana |
clone | Tokens from Clone protocol, from their repo: https://raw.githubusercontent.com/Clone-Protocol/token-list/main/token_mints.csv |
pump | Tokens 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 minthttps://tokens.jup.ag/token/So11111111111111111111111111111111111111112
GET token by mint
https://tokens.jup.ag/token/So11111111111111111111111111111111111111112
Parameter | Description |
---|---|
mint_address | Pass 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 onlyhttps://tokens.jup.ag/tokens_with_markets
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.