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": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
    "name": "USD Coin",
    "symbol": "USDC",
    "icon": "https://raw.githubusercontent.com/solana-labs/token-list/main/assets/mainnet/EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v/logo.png",
    "decimals": 6,
    "holderCount": 2500000,
    "fdv": 45000000000,
    "mcap": 45000000000,
    "usdPrice": 1,
    "liquidity": 50000000,
    "organicScore": 95,
    "organicScoreLabel": "high",
    "isVerified": true,
    "tags": [
      "verified",
      "community"
    ]
  }
]

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
​
decimals
number
​
twitter
string | null
​
telegram
string | null
​
website
string | null
​
dev
string | null

The token's developer address

​
circSupply
number | null
​
totalSupply
number | null
​
tokenProgram
string

The token program address

​
launchpad
string | null
​
partnerConfig
string | null
​
graduatedPool
string | null
​
graduatedAt
string | null
​
holderCount
number | null
​
fdv
number | null
​
mcap
number | null
​
usdPrice
number | null
​
priceBlockId
number | null
​
liquidity
number | null
​
stats5m
object
​
stats1h
object
​
stats6h
object
​
stats24h
object
​
firstPool
object
​
audit
object
​
organicScore
number
​
organicScoreLabel
enum<string>
Available options:
high,
medium,
low
​
isVerified
boolean | null
​
cexes
string[] | null
​
tags
string[] | null
​
updatedAt
string<date-time>