Skip to main content
GET
/
search
search
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,
    "organicScoreLabel": "high",
    "isVerified": true,
    "tags": [
      "<string>"
    ],
    "updatedAt": "2023-11-07T05:31:56Z"
  }
]

Authorizations

x-api-key
string
header
required

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

Query Parameters

query
string
default:EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
required
  • 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

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