curl --request GET \
--url https://api.jup.ag/ultra/v1/search \
--header 'x-api-key: <api-key>'[
{
"id": "<string>",
"name": "<string>",
"symbol": "<string>",
"icon": "<string>",
"decimals": 123,
"tokenProgram": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"twitter": "<string>",
"telegram": "<string>",
"website": "<string>",
"discord": "<string>",
"instagram": "<string>",
"tiktok": "<string>",
"otherUrl": "<string>",
"dev": "<string>",
"mintAuthority": "<string>",
"freezeAuthority": "<string>",
"issuer": "<string>",
"circSupply": 123,
"totalSupply": 123,
"launchpad": "<string>",
"partnerConfig": "<string>",
"graduatedPool": "<string>",
"graduatedAt": "<string>",
"holderCount": 123,
"fdv": 123,
"mcap": 123,
"usdPrice": 123,
"priceBlockId": 123,
"liquidity": 123,
"fees": 123,
"apy": {
"jupEarn": 123
},
"stats5m": {
"priceChange": 123,
"holderChange": 123,
"liquidityChange": 123,
"volumeChange": 123,
"buyVolume": 123,
"sellVolume": 123,
"buyOrganicVolume": 123,
"sellOrganicVolume": 123,
"numBuys": 123,
"numSells": 123,
"numTraders": 123,
"numOrganicBuyers": 123,
"numNetBuyers": 123
},
"stats1h": {
"priceChange": 123,
"holderChange": 123,
"liquidityChange": 123,
"volumeChange": 123,
"buyVolume": 123,
"sellVolume": 123,
"buyOrganicVolume": 123,
"sellOrganicVolume": 123,
"numBuys": 123,
"numSells": 123,
"numTraders": 123,
"numOrganicBuyers": 123,
"numNetBuyers": 123
},
"stats6h": {
"priceChange": 123,
"holderChange": 123,
"liquidityChange": 123,
"volumeChange": 123,
"buyVolume": 123,
"sellVolume": 123,
"buyOrganicVolume": 123,
"sellOrganicVolume": 123,
"numBuys": 123,
"numSells": 123,
"numTraders": 123,
"numOrganicBuyers": 123,
"numNetBuyers": 123
},
"stats24h": {
"priceChange": 123,
"holderChange": 123,
"liquidityChange": 123,
"volumeChange": 123,
"buyVolume": 123,
"sellVolume": 123,
"buyOrganicVolume": 123,
"sellOrganicVolume": 123,
"numBuys": 123,
"numSells": 123,
"numTraders": 123,
"numOrganicBuyers": 123,
"numNetBuyers": 123
},
"stats7d": {
"priceChange": 123,
"holderChange": 123,
"liquidityChange": 123,
"volumeChange": 123,
"buyVolume": 123,
"sellVolume": 123,
"buyOrganicVolume": 123,
"sellOrganicVolume": 123,
"numBuys": 123,
"numSells": 123,
"numTraders": 123,
"numOrganicBuyers": 123,
"numNetBuyers": 123
},
"stats30d": {
"priceChange": 123,
"holderChange": 123,
"liquidityChange": 123,
"volumeChange": 123,
"buyVolume": 123,
"sellVolume": 123,
"buyOrganicVolume": 123,
"sellOrganicVolume": 123,
"numBuys": 123,
"numSells": 123,
"numTraders": 123,
"numOrganicBuyers": 123,
"numNetBuyers": 123
},
"firstPool": {
"id": "<string>",
"createdAt": "<string>"
},
"audit": {
"isSus": true,
"mintAuthorityDisabled": true,
"freezeAuthorityDisabled": true,
"topHoldersPercentage": 123,
"devBalancePercentage": 123,
"devMints": 123
},
"organicScore": 123,
"isVerified": true,
"tags": [
"<string>"
],
"updatedAt": "2023-11-07T05:31:56Z"
}
]Search Token
Request a search by token’s symbol, name or mint address
curl --request GET \
--url https://api.jup.ag/ultra/v1/search \
--header 'x-api-key: <api-key>'[
{
"id": "<string>",
"name": "<string>",
"symbol": "<string>",
"icon": "<string>",
"decimals": 123,
"tokenProgram": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"twitter": "<string>",
"telegram": "<string>",
"website": "<string>",
"discord": "<string>",
"instagram": "<string>",
"tiktok": "<string>",
"otherUrl": "<string>",
"dev": "<string>",
"mintAuthority": "<string>",
"freezeAuthority": "<string>",
"issuer": "<string>",
"circSupply": 123,
"totalSupply": 123,
"launchpad": "<string>",
"partnerConfig": "<string>",
"graduatedPool": "<string>",
"graduatedAt": "<string>",
"holderCount": 123,
"fdv": 123,
"mcap": 123,
"usdPrice": 123,
"priceBlockId": 123,
"liquidity": 123,
"fees": 123,
"apy": {
"jupEarn": 123
},
"stats5m": {
"priceChange": 123,
"holderChange": 123,
"liquidityChange": 123,
"volumeChange": 123,
"buyVolume": 123,
"sellVolume": 123,
"buyOrganicVolume": 123,
"sellOrganicVolume": 123,
"numBuys": 123,
"numSells": 123,
"numTraders": 123,
"numOrganicBuyers": 123,
"numNetBuyers": 123
},
"stats1h": {
"priceChange": 123,
"holderChange": 123,
"liquidityChange": 123,
"volumeChange": 123,
"buyVolume": 123,
"sellVolume": 123,
"buyOrganicVolume": 123,
"sellOrganicVolume": 123,
"numBuys": 123,
"numSells": 123,
"numTraders": 123,
"numOrganicBuyers": 123,
"numNetBuyers": 123
},
"stats6h": {
"priceChange": 123,
"holderChange": 123,
"liquidityChange": 123,
"volumeChange": 123,
"buyVolume": 123,
"sellVolume": 123,
"buyOrganicVolume": 123,
"sellOrganicVolume": 123,
"numBuys": 123,
"numSells": 123,
"numTraders": 123,
"numOrganicBuyers": 123,
"numNetBuyers": 123
},
"stats24h": {
"priceChange": 123,
"holderChange": 123,
"liquidityChange": 123,
"volumeChange": 123,
"buyVolume": 123,
"sellVolume": 123,
"buyOrganicVolume": 123,
"sellOrganicVolume": 123,
"numBuys": 123,
"numSells": 123,
"numTraders": 123,
"numOrganicBuyers": 123,
"numNetBuyers": 123
},
"stats7d": {
"priceChange": 123,
"holderChange": 123,
"liquidityChange": 123,
"volumeChange": 123,
"buyVolume": 123,
"sellVolume": 123,
"buyOrganicVolume": 123,
"sellOrganicVolume": 123,
"numBuys": 123,
"numSells": 123,
"numTraders": 123,
"numOrganicBuyers": 123,
"numNetBuyers": 123
},
"stats30d": {
"priceChange": 123,
"holderChange": 123,
"liquidityChange": 123,
"volumeChange": 123,
"buyVolume": 123,
"sellVolume": 123,
"buyOrganicVolume": 123,
"sellOrganicVolume": 123,
"numBuys": 123,
"numSells": 123,
"numTraders": 123,
"numOrganicBuyers": 123,
"numNetBuyers": 123
},
"firstPool": {
"id": "<string>",
"createdAt": "<string>"
},
"audit": {
"isSus": true,
"mintAuthorityDisabled": true,
"freezeAuthorityDisabled": true,
"topHoldersPercentage": 123,
"devBalancePercentage": 123,
"devMints": 123
},
"organicScore": 123,
"isVerified": true,
"tags": [
"<string>"
],
"updatedAt": "2023-11-07T05:31:56Z"
}
]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.
Authorizations
Get API key via https://developers.jup.ag/portal
Query Parameters
- 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
Response
Successful response
The token's mint address
URL to the token's logo image
The token program address (SPL Token or Token-2022)
Token creation timestamp
The token's developer wallet address
Mint authority address (present when mint authority is not disabled)
Freeze authority address (present when freeze authority is not disabled)
Token issuer name (e.g., "Circle" for USDC)
Fully diluted valuation in USD
Market cap in USD
Solana block number for the price data point
Total liquidity in USD
Trading fees in USD
APY data, only present for assets listed on Jupiter Lend's Earn
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
7-day stats (typically only priceChange, but may include volume fields)
Show child attributes
Show child attributes
30-day stats (typically only priceChange, but may include volume fields)
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Audit information. All sub-fields are conditional and vary per token.
Show child attributes
Show child attributes
Organic trading activity score (0-100)
high, medium, low Last data update timestamp
Was this page helpful?
