Catalog
Search tokens
Find tokens by name, symbol or address, on one chain or all of them. An address can also be
a pool’s (a Uniswap V4 or PancakeSwap Infinity pool id too, 0x and 64 hex digits): the
token(s) the pool trades come first; or a wallet’s: the tokens it created, newest first.
Rows found by address come before the other matches; each token once, at most limit.
Rows carry the whole token row as /tokens/{chain}/{address} gives it (stats, pool, supply,
safety, graduation and curve progress), read behind the answer when not held yet.
GET
/
search
Search tokens
curl --request GET \
--url https://api.raze.bot/search \
--header 'x-api-key: <api-key>'import requests
url = "https://api.raze.bot/search"
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/search', 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/search",
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/search"
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/search")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.raze.bot/search")
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>"
}
}
]
}{
"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"
}
}Matches name, symbol or address. Pass
chain to stay on one chain; without it every chain is searched. Rows are token summaries; call Get token for the full object.Query Parameters
⌘I
Search tokens
curl --request GET \
--url https://api.raze.bot/search \
--header 'x-api-key: <api-key>'import requests
url = "https://api.raze.bot/search"
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/search', 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/search",
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/search"
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/search")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.raze.bot/search")
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>"
}
}
]
}{
"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"
}
}