Tokens
Get many tokens
Price, market cap, liquidity, holders, supply, stats and main pool for up to 50 tokens across
chains, in the order asked; unknown tokens, and addresses that are not of their chain, are
left out (a token only one of our sources knows is included). Description, links, creator
and launchpad are filled for every token known; so is safety, the same as the
single-token endpoint’s: the call waits at most a second for what the API does not hold yet;
a token whose safety did not arrive in time has the last the API holds (at most 10 minutes
old) or null, and has it on the next call. Every value is the one the single-token
endpoint, the lists and the launchpad boards give for the same token.
GET
/
tokens
Many tokens in one call
curl --request GET \
--url https://api.raze.bot/tokens \
--header 'x-api-key: <api-key>'import requests
url = "https://api.raze.bot/tokens"
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/tokens', 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/tokens",
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/tokens"
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/tokens")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.raze.bot/tokens")
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>",
"decimals": 123,
"image": "<string>",
"banner": "<string>",
"description": "<string>",
"socials": {
"twitter": "<string>",
"telegram": "<string>",
"website": "<string>",
"discord": "<string>"
},
"createdAt": 123,
"creator": "<string>",
"totalSupply": 123,
"circulatingSupply": 123,
"priceUsd": 123,
"marketCapUsd": 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
}
}
]
}{
"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"
}
}Up to 50 tokens, on any mix of chains, in one call:
?ids=sol:<mint>,bsc:<address>,…. The answer keeps your order and leaves out tokens nobody knows.
Every token has the same values as the single-token read: price, market cap, liquidity, holders, supply, stats, main pool, launchpad, socials and safety. The call waits at most a second for what the API does not hold yet; a token whose safety did not arrive in time has the last the API holds (at most 10 minutes old) or null, and has it on the next call.
More than 50 ids is a 400, and so is an id that is not chain:address. If one chain cannot be read, the whole call answers 503 with Retry-After.Query Parameters
⌘I
Many tokens in one call
curl --request GET \
--url https://api.raze.bot/tokens \
--header 'x-api-key: <api-key>'import requests
url = "https://api.raze.bot/tokens"
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/tokens', 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/tokens",
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/tokens"
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/tokens")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.raze.bot/tokens")
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>",
"decimals": 123,
"image": "<string>",
"banner": "<string>",
"description": "<string>",
"socials": {
"twitter": "<string>",
"telegram": "<string>",
"website": "<string>",
"discord": "<string>"
},
"createdAt": 123,
"creator": "<string>",
"totalSupply": 123,
"circulatingSupply": 123,
"priceUsd": 123,
"marketCapUsd": 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
}
}
]
}{
"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"
}
}