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"
  }
]

Authorizations

x-api-key
string
header
required

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

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