category
curl --request GET \
--url https://api.jup.ag/tokens/v2/{category}/{interval} \
--header 'x-api-key: <api-key>'import requests
url = "https://api.jup.ag/tokens/v2/{category}/{interval}"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://api.jup.ag/tokens/v2/{category}/{interval}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.jup.ag/tokens/v2/{category}/{interval}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.jup.ag/tokens/v2/{category}/{interval}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-api-key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.jup.ag/tokens/v2/{category}/{interval}")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.jup.ag/tokens/v2/{category}/{interval}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body[
{
"id": "So11111111111111111111111111111111111111112",
"name": "Wrapped SOL",
"symbol": "SOL",
"decimals": 9,
"usdPrice": 171.34,
"stats24h": {
"priceChange": 2.5,
"volumeChange": 15000000,
"numBuys": 50000,
"numSells": 48000
}
}
]{
"error": "<string>"
}{
"error": "<string>"
}Token Information
Category
Returns an array of mints and their information for the given category and interval
GET
/
{category}
/
{interval}
category
curl --request GET \
--url https://api.jup.ag/tokens/v2/{category}/{interval} \
--header 'x-api-key: <api-key>'import requests
url = "https://api.jup.ag/tokens/v2/{category}/{interval}"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://api.jup.ag/tokens/v2/{category}/{interval}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.jup.ag/tokens/v2/{category}/{interval}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.jup.ag/tokens/v2/{category}/{interval}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-api-key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.jup.ag/tokens/v2/{category}/{interval}")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.jup.ag/tokens/v2/{category}/{interval}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body[
{
"id": "So11111111111111111111111111111111111111112",
"name": "Wrapped SOL",
"symbol": "SOL",
"decimals": 9,
"usdPrice": 171.34,
"stats24h": {
"priceChange": 2.5,
"volumeChange": 15000000,
"numBuys": 50000,
"numSells": 48000
}
}
]{
"error": "<string>"
}{
"error": "<string>"
}Authorizations
Get API key via https://developers.jup.ag/portal
Path Parameters
- 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 - Query by time interval for more accuracy
Available options:
5m, 1h, 6h, 24h Query Parameters
- Maximum number of results to return (default 50, max 100)
Required range:
1 <= x <= 100Response
Successful response
The token's mint address
URL to the token's logo image
The token program address (SPL Token or Token-2022)
Token creation timestamp
The token's developer wallet address
Mint authority address (present when mint authority is not disabled)
Freeze authority address (present when freeze authority is not disabled)
Fully diluted valuation in USD
Market cap in USD
Solana block number for the price data point
Total liquidity in USD
APY data, only present for assets listed on Jupiter Lend's Earn
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Audit information. All sub-fields are conditional and vary per token.
Show child attributes
Show child attributes
Organic trading activity score (0-100)
Available options:
high, medium, low Last data update timestamp
Was this page helpful?