Skip to main content
GET
/
search
search
curl --request GET \
  --url https://api.jup.ag/tokens/v2/search \
  --header 'x-api-key: <api-key>'
[
  {
    "id": "JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN",
    "name": "Jupiter",
    "symbol": "JUP",
    "icon": "https://static.jup.ag/jup/icon.png",
    "decimals": 6,
    "tokenProgram": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA",
    "createdAt": "2024-06-07T10:56:42.584Z",
    "twitter": "https://twitter.com/JupiterExchange",
    "website": "https://jup.ag",
    "dev": "JUPhop9E8ZfdJ5FNHhxQt4uAih822Vs4QpqsWcewFbq",
    "circSupply": 3243891294.88,
    "totalSupply": 6863982654.38,
    "firstPool": {
      "id": "2pspvjWWaf3dNgt3jsgSzFCNvMGPb7t8FrEYvLGjvcCe",
      "createdAt": "2024-01-29T17:33:29Z"
    },
    "holderCount": 857254,
    "audit": {
      "mintAuthorityDisabled": true,
      "freezeAuthorityDisabled": true,
      "topHoldersPercentage": 15.45,
      "devMints": 1
    },
    "organicScore": 97.98,
    "organicScoreLabel": "high",
    "isVerified": true,
    "tags": [
      "community",
      "strict",
      "verified"
    ],
    "fdv": 971593450.82,
    "mcap": 459171256.1,
    "usdPrice": 0.1415,
    "priceBlockId": 402118601,
    "liquidity": 2992387.89,
    "stats24h": {
      "priceChange": -8.27,
      "holderChange": -0.03,
      "liquidityChange": -6.96,
      "volumeChange": 30.39,
      "buyVolume": 1821969.64,
      "sellVolume": 2016195.15,
      "numBuys": 33979,
      "numSells": 31608,
      "numTraders": 5174
    },
    "updatedAt": "2026-02-23T04:55:12.461Z"
  }
]

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

​
x-api-key
string
header
required

Get API key via https://developers.jup.ag/portal

Query Parameters

​
query
string
required
  • Search for a token and its information by its symbol, name or mint address
  • Comma-separate to ONLY search for multiple mint addresses
  • Limit to 100 mint addresses in query
  • Default to 20 mints in response when searching via symbol or name

Response

Successful response

​
id
string

The token's mint address

​
name
string
​
symbol
string
​
icon
string | null

URL to the token's logo image

​
decimals
number
​
tokenProgram
string

The token program address (SPL Token or Token-2022)

​
createdAt
string<date-time>

Token creation timestamp

​
twitter
string | null
​
telegram
string | null
​
website
string | null
​
discord
string | null
​
instagram
string | null
​
tiktok
string | null
​
otherUrl
string | null
​
dev
string | null

The token's developer wallet address

​
mintAuthority
string | null

Mint authority address (present when mint authority is not disabled)

​
freezeAuthority
string | null

Freeze authority address (present when freeze authority is not disabled)

​
circSupply
number | null
​
totalSupply
number | null
​
launchpad
string | null
​
partnerConfig
string | null
​
graduatedPool
string | null
​
graduatedAt
string | null
​
holderCount
number | null
​
fdv
number | null

Fully diluted valuation in USD

​
mcap
number | null

Market cap in USD

​
usdPrice
number | null
​
priceBlockId
number | null

Solana block number for the price data point

​
liquidity
number | null

Total liquidity in USD

​
apy
object

APY data, only present for assets listed on Jupiter Lend's Earn

​
stats5m
object
​
stats1h
object
​
stats6h
object
​
stats24h
object
​
firstPool
object
​
audit
object

Audit information. All sub-fields are conditional and vary per token.

​
organicScore
number

Organic trading activity score (0-100)

​
organicScoreLabel
enum<string>
Available options:
high,
medium,
low
​
isVerified
boolean | null
​
tags
string[] | null
​
updatedAt
string<date-time>

Last data update timestamp