Discovery
Trending
Tokens ranked on one chain over a window, each with its rank (1 first) and the window’s
stats. Every row also carries the whole token row as /tokens/{chain}/{address} gives it
(stats, statsAt, pool, supply, safety, graduation and curve progress): a row not held
yet is waited for at most 800 ms, then read behind the answer, and has it on the next call.
In window, buyVolumeUsd and sellVolumeUsd are always null on this route. A token
that left its launchpad has launchpad.graduatedAt; its createdAt can be null for a few
seconds the first time it appears, while its birth is read. sort=age is newest token first
by createdAt. Live: channel trending.
GET
/
trending
Trending tokens
curl --request GET \
--url https://api.raze.bot/trending \
--header 'x-api-key: <api-key>'import requests
url = "https://api.raze.bot/trending"
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.raze.bot/trending', 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.raze.bot/trending",
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.raze.bot/trending"
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.raze.bot/trending")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.raze.bot/trending")
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{
"data": [
{
"chain": "<string>",
"address": "<string>",
"name": "<string>",
"symbol": "<string>",
"image": "<string>",
"createdAt": 123,
"creator": "<string>",
"priceUsd": 123,
"marketCapUsd": 123,
"totalSupply": 123,
"circulatingSupply": 123,
"liquidityUsd": 123,
"holders": 123,
"stats": {
"1m": {
"priceChangePercent": 123,
"openPriceUsd": 123,
"volumeUsd": 123,
"buyVolumeUsd": 123,
"sellVolumeUsd": 123,
"buys": 123,
"sells": 123,
"trades": 123
},
"5m": {
"priceChangePercent": 123,
"openPriceUsd": 123,
"volumeUsd": 123,
"buyVolumeUsd": 123,
"sellVolumeUsd": 123,
"buys": 123,
"sells": 123,
"trades": 123
},
"1h": {
"priceChangePercent": 123,
"openPriceUsd": 123,
"volumeUsd": 123,
"buyVolumeUsd": 123,
"sellVolumeUsd": 123,
"buys": 123,
"sells": 123,
"trades": 123
},
"6h": {
"priceChangePercent": 123,
"openPriceUsd": 123,
"volumeUsd": 123,
"buyVolumeUsd": 123,
"sellVolumeUsd": 123,
"buys": 123,
"sells": 123,
"trades": 123
},
"24h": {
"priceChangePercent": 123,
"openPriceUsd": 123,
"volumeUsd": 123,
"buyVolumeUsd": 123,
"sellVolumeUsd": 123,
"buys": 123,
"sells": 123,
"trades": 123
}
},
"statsAt": 123,
"pool": {
"address": "<string>",
"dex": "<string>",
"quoteToken": "<string>",
"quoteSymbol": "<string>",
"liquidityUsd": 123
},
"launchpad": {
"name": "<string>",
"progressPercent": 123,
"graduated": true,
"graduatedAt": 123,
"graduatedPool": "<string>",
"graduationMarketCapUsd": 123
},
"safety": {
"top10Percent": 123,
"devPercent": 123,
"creatorPercent": 123,
"snipersPercent": 123,
"bundlersPercent": 123,
"insidersPercent": 123,
"botsPercent": 123,
"freshWalletsPercent": 123,
"bluechipPercent": 123,
"creatorLaunches": 123,
"honeypot": true,
"mintRenounced": true,
"freezeRenounced": true,
"ownershipRenounced": true,
"mintExtensions": [
"<string>"
],
"buyTaxPercent": 123,
"sellTaxPercent": 123
},
"socials": {
"twitter": "<string>",
"telegram": "<string>",
"website": "<string>",
"discord": "<string>"
},
"window": {
"priceChangePercent": 123,
"openPriceUsd": 123,
"volumeUsd": 123,
"buyVolumeUsd": 123,
"sellVolumeUsd": 123,
"buys": 123,
"sells": 123,
"trades": 123
},
"rank": 123
}
]
}{
"error": {
"code": "bad_request",
"message": "unknown chain 'xyz', use one of: sol, eth, bsc, base, robinhood"
}
}{
"error": {
"code": "unauthorized",
"message": "missing or unknown API key (send it as x-api-key)"
}
}{
"error": {
"code": "rate_limited",
"message": "too many requests"
}
}{
"error": {
"code": "upstream_unavailable",
"message": "could not load trades, try again"
}
}Tokens on one chain (default
sol) ranked over interval, by trades unless you pick another sort. Each row is a token summary with the whole token row as Get token gives it (stats, pool, supply, safety, graduation, curve progress), its rank (1 first), and window, the stats of that interval. A row not held yet is waited for at most 800 ms, then read behind the answer. In window, buyVolumeUsd and sellVolumeUsd are always null on this route; buys, sells, trades, volumeUsd, openPriceUsd and priceChangePercent are filled. sort=age is newest token first.
Live: the trending channel sends the ranking, then its changes and a buy-pressure summary about every 10 seconds.Query Parameters
⌘I
Trending tokens
curl --request GET \
--url https://api.raze.bot/trending \
--header 'x-api-key: <api-key>'import requests
url = "https://api.raze.bot/trending"
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.raze.bot/trending', 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.raze.bot/trending",
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.raze.bot/trending"
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.raze.bot/trending")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.raze.bot/trending")
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{
"data": [
{
"chain": "<string>",
"address": "<string>",
"name": "<string>",
"symbol": "<string>",
"image": "<string>",
"createdAt": 123,
"creator": "<string>",
"priceUsd": 123,
"marketCapUsd": 123,
"totalSupply": 123,
"circulatingSupply": 123,
"liquidityUsd": 123,
"holders": 123,
"stats": {
"1m": {
"priceChangePercent": 123,
"openPriceUsd": 123,
"volumeUsd": 123,
"buyVolumeUsd": 123,
"sellVolumeUsd": 123,
"buys": 123,
"sells": 123,
"trades": 123
},
"5m": {
"priceChangePercent": 123,
"openPriceUsd": 123,
"volumeUsd": 123,
"buyVolumeUsd": 123,
"sellVolumeUsd": 123,
"buys": 123,
"sells": 123,
"trades": 123
},
"1h": {
"priceChangePercent": 123,
"openPriceUsd": 123,
"volumeUsd": 123,
"buyVolumeUsd": 123,
"sellVolumeUsd": 123,
"buys": 123,
"sells": 123,
"trades": 123
},
"6h": {
"priceChangePercent": 123,
"openPriceUsd": 123,
"volumeUsd": 123,
"buyVolumeUsd": 123,
"sellVolumeUsd": 123,
"buys": 123,
"sells": 123,
"trades": 123
},
"24h": {
"priceChangePercent": 123,
"openPriceUsd": 123,
"volumeUsd": 123,
"buyVolumeUsd": 123,
"sellVolumeUsd": 123,
"buys": 123,
"sells": 123,
"trades": 123
}
},
"statsAt": 123,
"pool": {
"address": "<string>",
"dex": "<string>",
"quoteToken": "<string>",
"quoteSymbol": "<string>",
"liquidityUsd": 123
},
"launchpad": {
"name": "<string>",
"progressPercent": 123,
"graduated": true,
"graduatedAt": 123,
"graduatedPool": "<string>",
"graduationMarketCapUsd": 123
},
"safety": {
"top10Percent": 123,
"devPercent": 123,
"creatorPercent": 123,
"snipersPercent": 123,
"bundlersPercent": 123,
"insidersPercent": 123,
"botsPercent": 123,
"freshWalletsPercent": 123,
"bluechipPercent": 123,
"creatorLaunches": 123,
"honeypot": true,
"mintRenounced": true,
"freezeRenounced": true,
"ownershipRenounced": true,
"mintExtensions": [
"<string>"
],
"buyTaxPercent": 123,
"sellTaxPercent": 123
},
"socials": {
"twitter": "<string>",
"telegram": "<string>",
"website": "<string>",
"discord": "<string>"
},
"window": {
"priceChangePercent": 123,
"openPriceUsd": 123,
"volumeUsd": 123,
"buyVolumeUsd": 123,
"sellVolumeUsd": 123,
"buys": 123,
"sells": 123,
"trades": 123
},
"rank": 123
}
]
}{
"error": {
"code": "bad_request",
"message": "unknown chain 'xyz', use one of: sol, eth, bsc, base, robinhood"
}
}{
"error": {
"code": "unauthorized",
"message": "missing or unknown API key (send it as x-api-key)"
}
}{
"error": {
"code": "rate_limited",
"message": "too many requests"
}
}{
"error": {
"code": "upstream_unavailable",
"message": "could not load trades, try again"
}
}