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,
    "fees": 53.54,
    "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
    },
    "stats7d": {
      "priceChange": -12.52
    },
    "stats30d": {
      "priceChange": -28.11
    },
    "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)

issuer
string | null

Token issuer name (e.g., "Circle" for USDC)

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

fees
number | null

Trading fees in USD

apy
object

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

stats5m
object
stats1h
object
stats6h
object
stats24h
object
stats7d
object

7-day stats (typically only priceChange, but may include volume fields)

stats30d
object

30-day stats (typically only priceChange, but may include volume fields)

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