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

Documentation Index

Fetch the complete documentation index at: https://dev.jup.ag/docs/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
x-api-key
string
header
required

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

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

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