Skip to main content
GET
/
{category}
/
{interval}
category
curl --request GET \
  --url https://api.jup.ag/tokens/v2/{category}/{interval} \
  --header 'x-api-key: <api-key>'
[
  {
    "id": "So11111111111111111111111111111111111111112",
    "name": "Wrapped SOL",
    "symbol": "SOL",
    "decimals": 9,
    "usdPrice": 171.34,
    "stats24h": {
      "priceChange": 2.5,
      "volumeChange": 15000000,
      "numBuys": 50000,
      "numSells": 48000
    }
  }
]

Authorizations

​
x-api-key
string
header
required

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

Path Parameters

​
category
enum<string>
required
  • Top tokens in different trading categories
  • The result filters out generic top tokens like SOL, USDC, etc
  • Default to 50 mints in response
Available options:
toporganicscore,
toptraded,
toptrending
​
interval
enum<string>
required
  • Query by time interval for more accuracy
Available options:
5m,
1h,
6h,
24h

Query Parameters

​
limit
integer
  • Maximum number of results to return (default 50, max 100)
Required range: 1 <= x <= 100

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>