Tokens ranked by trending score.
curl --request POST \
--url https://{host}/v1/trending \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"chains": [],
"filters": {
"ageMinutes": {
"max": 1,
"min": 1
},
"anchorSymbols": [
"<string>"
],
"bondingCurvePercent": {
"max": 123,
"min": 123
},
"bundlerSupplyPercent": {
"max": "123.456789",
"min": "123.456789"
},
"buys": {
"max": 1,
"min": 1
},
"devHoldingPercent": {
"max": 123,
"min": 123
},
"dexPaid": true,
"excludeAnnotations": [
{
"kind": "mayhem_mode"
}
],
"excludeDevAddresses": [
"<string>"
],
"excludeFundingAddresses": [
"<string>"
],
"excludeSymbolOrName": [
"<string>"
],
"excludeTwitter": [
"<string>"
],
"excludeWebsites": [
"<string>"
],
"globalFeesPaidNative": {
"max": "123.456789",
"min": "123.456789"
},
"globalFeesPaidUsd": {
"max": "123.456789",
"min": "123.456789"
},
"holderCount": {
"max": 1,
"min": 1
},
"insiderSupplyPercent": {
"max": "123.456789",
"min": "123.456789"
},
"lastActivityMinutes": 1,
"liquidityUsd": {
"max": "123.456789",
"min": "123.456789"
},
"marketCapUsd": {
"max": "123.456789",
"min": "123.456789"
},
"maxGraduationStaleMinutes": 1,
"proTraderCount": {
"max": 1,
"min": 1
},
"protocols": [
"<string>"
],
"sells": {
"max": 1,
"min": 1
},
"snipersSupplyPercent": {
"max": 123,
"min": 123
},
"symbolOrName": [
"<string>"
],
"top10HoldersPercent": {
"max": 123,
"min": 123
},
"twitterReuseCount": {
"max": 1,
"min": 1
},
"txns": {
"max": 1,
"min": 1
},
"volumeUsd": {
"max": "123.456789",
"min": "123.456789"
},
"withAtLeastOneSocial": true
},
"limit": 1
}
'import requests
url = "https://{host}/v1/trending"
payload = {
"chains": [],
"filters": {
"ageMinutes": {
"max": 1,
"min": 1
},
"anchorSymbols": ["<string>"],
"bondingCurvePercent": {
"max": 123,
"min": 123
},
"bundlerSupplyPercent": {
"max": "123.456789",
"min": "123.456789"
},
"buys": {
"max": 1,
"min": 1
},
"devHoldingPercent": {
"max": 123,
"min": 123
},
"dexPaid": True,
"excludeAnnotations": [{ "kind": "mayhem_mode" }],
"excludeDevAddresses": ["<string>"],
"excludeFundingAddresses": ["<string>"],
"excludeSymbolOrName": ["<string>"],
"excludeTwitter": ["<string>"],
"excludeWebsites": ["<string>"],
"globalFeesPaidNative": {
"max": "123.456789",
"min": "123.456789"
},
"globalFeesPaidUsd": {
"max": "123.456789",
"min": "123.456789"
},
"holderCount": {
"max": 1,
"min": 1
},
"insiderSupplyPercent": {
"max": "123.456789",
"min": "123.456789"
},
"lastActivityMinutes": 1,
"liquidityUsd": {
"max": "123.456789",
"min": "123.456789"
},
"marketCapUsd": {
"max": "123.456789",
"min": "123.456789"
},
"maxGraduationStaleMinutes": 1,
"proTraderCount": {
"max": 1,
"min": 1
},
"protocols": ["<string>"],
"sells": {
"max": 1,
"min": 1
},
"snipersSupplyPercent": {
"max": 123,
"min": 123
},
"symbolOrName": ["<string>"],
"top10HoldersPercent": {
"max": 123,
"min": 123
},
"twitterReuseCount": {
"max": 1,
"min": 1
},
"txns": {
"max": 1,
"min": 1
},
"volumeUsd": {
"max": "123.456789",
"min": "123.456789"
},
"withAtLeastOneSocial": True
},
"limit": 1
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
chains: [],
filters: {
ageMinutes: {max: 1, min: 1},
anchorSymbols: ['<string>'],
bondingCurvePercent: {max: 123, min: 123},
bundlerSupplyPercent: {max: '123.456789', min: '123.456789'},
buys: {max: 1, min: 1},
devHoldingPercent: {max: 123, min: 123},
dexPaid: true,
excludeAnnotations: [{kind: 'mayhem_mode'}],
excludeDevAddresses: ['<string>'],
excludeFundingAddresses: ['<string>'],
excludeSymbolOrName: ['<string>'],
excludeTwitter: ['<string>'],
excludeWebsites: ['<string>'],
globalFeesPaidNative: {max: '123.456789', min: '123.456789'},
globalFeesPaidUsd: {max: '123.456789', min: '123.456789'},
holderCount: {max: 1, min: 1},
insiderSupplyPercent: {max: '123.456789', min: '123.456789'},
lastActivityMinutes: 1,
liquidityUsd: {max: '123.456789', min: '123.456789'},
marketCapUsd: {max: '123.456789', min: '123.456789'},
maxGraduationStaleMinutes: 1,
proTraderCount: {max: 1, min: 1},
protocols: ['<string>'],
sells: {max: 1, min: 1},
snipersSupplyPercent: {max: 123, min: 123},
symbolOrName: ['<string>'],
top10HoldersPercent: {max: 123, min: 123},
twitterReuseCount: {max: 1, min: 1},
txns: {max: 1, min: 1},
volumeUsd: {max: '123.456789', min: '123.456789'},
withAtLeastOneSocial: true
},
limit: 1
})
};
fetch('https://{host}/v1/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://{host}/v1/trending",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'chains' => [
],
'filters' => [
'ageMinutes' => [
'max' => 1,
'min' => 1
],
'anchorSymbols' => [
'<string>'
],
'bondingCurvePercent' => [
'max' => 123,
'min' => 123
],
'bundlerSupplyPercent' => [
'max' => '123.456789',
'min' => '123.456789'
],
'buys' => [
'max' => 1,
'min' => 1
],
'devHoldingPercent' => [
'max' => 123,
'min' => 123
],
'dexPaid' => true,
'excludeAnnotations' => [
[
'kind' => 'mayhem_mode'
]
],
'excludeDevAddresses' => [
'<string>'
],
'excludeFundingAddresses' => [
'<string>'
],
'excludeSymbolOrName' => [
'<string>'
],
'excludeTwitter' => [
'<string>'
],
'excludeWebsites' => [
'<string>'
],
'globalFeesPaidNative' => [
'max' => '123.456789',
'min' => '123.456789'
],
'globalFeesPaidUsd' => [
'max' => '123.456789',
'min' => '123.456789'
],
'holderCount' => [
'max' => 1,
'min' => 1
],
'insiderSupplyPercent' => [
'max' => '123.456789',
'min' => '123.456789'
],
'lastActivityMinutes' => 1,
'liquidityUsd' => [
'max' => '123.456789',
'min' => '123.456789'
],
'marketCapUsd' => [
'max' => '123.456789',
'min' => '123.456789'
],
'maxGraduationStaleMinutes' => 1,
'proTraderCount' => [
'max' => 1,
'min' => 1
],
'protocols' => [
'<string>'
],
'sells' => [
'max' => 1,
'min' => 1
],
'snipersSupplyPercent' => [
'max' => 123,
'min' => 123
],
'symbolOrName' => [
'<string>'
],
'top10HoldersPercent' => [
'max' => 123,
'min' => 123
],
'twitterReuseCount' => [
'max' => 1,
'min' => 1
],
'txns' => [
'max' => 1,
'min' => 1
],
'volumeUsd' => [
'max' => '123.456789',
'min' => '123.456789'
],
'withAtLeastOneSocial' => true
],
'limit' => 1
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://{host}/v1/trending"
payload := strings.NewReader("{\n \"chains\": [],\n \"filters\": {\n \"ageMinutes\": {\n \"max\": 1,\n \"min\": 1\n },\n \"anchorSymbols\": [\n \"<string>\"\n ],\n \"bondingCurvePercent\": {\n \"max\": 123,\n \"min\": 123\n },\n \"bundlerSupplyPercent\": {\n \"max\": \"123.456789\",\n \"min\": \"123.456789\"\n },\n \"buys\": {\n \"max\": 1,\n \"min\": 1\n },\n \"devHoldingPercent\": {\n \"max\": 123,\n \"min\": 123\n },\n \"dexPaid\": true,\n \"excludeAnnotations\": [\n {\n \"kind\": \"mayhem_mode\"\n }\n ],\n \"excludeDevAddresses\": [\n \"<string>\"\n ],\n \"excludeFundingAddresses\": [\n \"<string>\"\n ],\n \"excludeSymbolOrName\": [\n \"<string>\"\n ],\n \"excludeTwitter\": [\n \"<string>\"\n ],\n \"excludeWebsites\": [\n \"<string>\"\n ],\n \"globalFeesPaidNative\": {\n \"max\": \"123.456789\",\n \"min\": \"123.456789\"\n },\n \"globalFeesPaidUsd\": {\n \"max\": \"123.456789\",\n \"min\": \"123.456789\"\n },\n \"holderCount\": {\n \"max\": 1,\n \"min\": 1\n },\n \"insiderSupplyPercent\": {\n \"max\": \"123.456789\",\n \"min\": \"123.456789\"\n },\n \"lastActivityMinutes\": 1,\n \"liquidityUsd\": {\n \"max\": \"123.456789\",\n \"min\": \"123.456789\"\n },\n \"marketCapUsd\": {\n \"max\": \"123.456789\",\n \"min\": \"123.456789\"\n },\n \"maxGraduationStaleMinutes\": 1,\n \"proTraderCount\": {\n \"max\": 1,\n \"min\": 1\n },\n \"protocols\": [\n \"<string>\"\n ],\n \"sells\": {\n \"max\": 1,\n \"min\": 1\n },\n \"snipersSupplyPercent\": {\n \"max\": 123,\n \"min\": 123\n },\n \"symbolOrName\": [\n \"<string>\"\n ],\n \"top10HoldersPercent\": {\n \"max\": 123,\n \"min\": 123\n },\n \"twitterReuseCount\": {\n \"max\": 1,\n \"min\": 1\n },\n \"txns\": {\n \"max\": 1,\n \"min\": 1\n },\n \"volumeUsd\": {\n \"max\": \"123.456789\",\n \"min\": \"123.456789\"\n },\n \"withAtLeastOneSocial\": true\n },\n \"limit\": 1\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://{host}/v1/trending")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"chains\": [],\n \"filters\": {\n \"ageMinutes\": {\n \"max\": 1,\n \"min\": 1\n },\n \"anchorSymbols\": [\n \"<string>\"\n ],\n \"bondingCurvePercent\": {\n \"max\": 123,\n \"min\": 123\n },\n \"bundlerSupplyPercent\": {\n \"max\": \"123.456789\",\n \"min\": \"123.456789\"\n },\n \"buys\": {\n \"max\": 1,\n \"min\": 1\n },\n \"devHoldingPercent\": {\n \"max\": 123,\n \"min\": 123\n },\n \"dexPaid\": true,\n \"excludeAnnotations\": [\n {\n \"kind\": \"mayhem_mode\"\n }\n ],\n \"excludeDevAddresses\": [\n \"<string>\"\n ],\n \"excludeFundingAddresses\": [\n \"<string>\"\n ],\n \"excludeSymbolOrName\": [\n \"<string>\"\n ],\n \"excludeTwitter\": [\n \"<string>\"\n ],\n \"excludeWebsites\": [\n \"<string>\"\n ],\n \"globalFeesPaidNative\": {\n \"max\": \"123.456789\",\n \"min\": \"123.456789\"\n },\n \"globalFeesPaidUsd\": {\n \"max\": \"123.456789\",\n \"min\": \"123.456789\"\n },\n \"holderCount\": {\n \"max\": 1,\n \"min\": 1\n },\n \"insiderSupplyPercent\": {\n \"max\": \"123.456789\",\n \"min\": \"123.456789\"\n },\n \"lastActivityMinutes\": 1,\n \"liquidityUsd\": {\n \"max\": \"123.456789\",\n \"min\": \"123.456789\"\n },\n \"marketCapUsd\": {\n \"max\": \"123.456789\",\n \"min\": \"123.456789\"\n },\n \"maxGraduationStaleMinutes\": 1,\n \"proTraderCount\": {\n \"max\": 1,\n \"min\": 1\n },\n \"protocols\": [\n \"<string>\"\n ],\n \"sells\": {\n \"max\": 1,\n \"min\": 1\n },\n \"snipersSupplyPercent\": {\n \"max\": 123,\n \"min\": 123\n },\n \"symbolOrName\": [\n \"<string>\"\n ],\n \"top10HoldersPercent\": {\n \"max\": 123,\n \"min\": 123\n },\n \"twitterReuseCount\": {\n \"max\": 1,\n \"min\": 1\n },\n \"txns\": {\n \"max\": 1,\n \"min\": 1\n },\n \"volumeUsd\": {\n \"max\": \"123.456789\",\n \"min\": \"123.456789\"\n },\n \"withAtLeastOneSocial\": true\n },\n \"limit\": 1\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://{host}/v1/trending")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"chains\": [],\n \"filters\": {\n \"ageMinutes\": {\n \"max\": 1,\n \"min\": 1\n },\n \"anchorSymbols\": [\n \"<string>\"\n ],\n \"bondingCurvePercent\": {\n \"max\": 123,\n \"min\": 123\n },\n \"bundlerSupplyPercent\": {\n \"max\": \"123.456789\",\n \"min\": \"123.456789\"\n },\n \"buys\": {\n \"max\": 1,\n \"min\": 1\n },\n \"devHoldingPercent\": {\n \"max\": 123,\n \"min\": 123\n },\n \"dexPaid\": true,\n \"excludeAnnotations\": [\n {\n \"kind\": \"mayhem_mode\"\n }\n ],\n \"excludeDevAddresses\": [\n \"<string>\"\n ],\n \"excludeFundingAddresses\": [\n \"<string>\"\n ],\n \"excludeSymbolOrName\": [\n \"<string>\"\n ],\n \"excludeTwitter\": [\n \"<string>\"\n ],\n \"excludeWebsites\": [\n \"<string>\"\n ],\n \"globalFeesPaidNative\": {\n \"max\": \"123.456789\",\n \"min\": \"123.456789\"\n },\n \"globalFeesPaidUsd\": {\n \"max\": \"123.456789\",\n \"min\": \"123.456789\"\n },\n \"holderCount\": {\n \"max\": 1,\n \"min\": 1\n },\n \"insiderSupplyPercent\": {\n \"max\": \"123.456789\",\n \"min\": \"123.456789\"\n },\n \"lastActivityMinutes\": 1,\n \"liquidityUsd\": {\n \"max\": \"123.456789\",\n \"min\": \"123.456789\"\n },\n \"marketCapUsd\": {\n \"max\": \"123.456789\",\n \"min\": \"123.456789\"\n },\n \"maxGraduationStaleMinutes\": 1,\n \"proTraderCount\": {\n \"max\": 1,\n \"min\": 1\n },\n \"protocols\": [\n \"<string>\"\n ],\n \"sells\": {\n \"max\": 1,\n \"min\": 1\n },\n \"snipersSupplyPercent\": {\n \"max\": 123,\n \"min\": 123\n },\n \"symbolOrName\": [\n \"<string>\"\n ],\n \"top10HoldersPercent\": {\n \"max\": 123,\n \"min\": 123\n },\n \"twitterReuseCount\": {\n \"max\": 1,\n \"min\": 1\n },\n \"txns\": {\n \"max\": 1,\n \"min\": 1\n },\n \"volumeUsd\": {\n \"max\": \"123.456789\",\n \"min\": \"123.456789\"\n },\n \"withAtLeastOneSocial\": true\n },\n \"limit\": 1\n}"
response = http.request(request)
puts response.read_body{
"deltas": [
{
"address": "<string>",
"chain": "solana",
"data": {
"address": "<string>",
"ath": {
"marketCap": {
"native": "123.456789",
"usd": "123.456789"
},
"marketCapAt": 123,
"price": {
"native": "123.456789",
"usd": "123.456789"
},
"priceAt": 123
},
"chain": "solana",
"createdAt": 123,
"creator": "<string>",
"decimals": 1,
"devFunding": {
"status": "unresolved",
"address": "<string>",
"sourceKind": "cex",
"sourceLabel": "<string>"
},
"dexes": [
"pumpswap",
"raydium"
],
"holders": {
"bundlerCount": 1,
"bundlerPct": "123.456789",
"count": 1,
"devPct": "123.456789",
"fomoCount": 1,
"fomoPct": "123.456789",
"freshWalletCount": 1,
"freshWalletPct": "123.456789",
"fundedByCexPct": "123.456789",
"insiderCount": 1,
"insiderPct": "123.456789",
"phishingCount": 1,
"phishingPct": "123.456789",
"proTraderCount": 1,
"proTraderPct": "123.456789",
"sniperCount": 1,
"sniperPct": "123.456789",
"top10Pct": "123.456789"
},
"liquidity": {
"native": "123.456789",
"usd": "123.456789"
},
"marketCap": {
"native": "123.456789",
"usd": "123.456789"
},
"metadata": {
"twitterReuseCount": 1,
"description": "<string>",
"discord": "<string>",
"telegram": "<string>",
"twitter": "<string>",
"website": "<string>"
},
"name": "<string>",
"price": {
"native": "123.456789",
"usd": "123.456789"
},
"security": {
"mintDisabled": true,
"rugPct": "123.456789",
"transferBlockable": true,
"buyTaxBps": 100,
"dividendMinHolding": "123.456789",
"dividendToken": "<string>",
"lpBurntPct": "123.456789",
"sellTaxBps": 200,
"totalBuyBps": 100,
"totalSellBps": 200,
"transferFeeBps": 250
},
"stats": {
"1h": {
"buyCount": 1,
"buyVolume": {
"native": "123.456789",
"usd": "123.456789"
},
"priceChangePct": "123.456789",
"sellCount": 1,
"sellVolume": {
"native": "123.456789",
"usd": "123.456789"
},
"volume": {
"native": "123.456789",
"usd": "123.456789"
}
},
"24h": {
"buyCount": 1,
"buyVolume": {
"native": "123.456789",
"usd": "123.456789"
},
"priceChangePct": "123.456789",
"sellCount": 1,
"sellVolume": {
"native": "123.456789",
"usd": "123.456789"
},
"volume": {
"native": "123.456789",
"usd": "123.456789"
}
},
"30m": {
"buyCount": 1,
"buyVolume": {
"native": "123.456789",
"usd": "123.456789"
},
"priceChangePct": "123.456789",
"sellCount": 1,
"sellVolume": {
"native": "123.456789",
"usd": "123.456789"
},
"volume": {
"native": "123.456789",
"usd": "123.456789"
}
},
"5m": {
"buyCount": 1,
"buyVolume": {
"native": "123.456789",
"usd": "123.456789"
},
"priceChangePct": "123.456789",
"sellCount": 1,
"sellVolume": {
"native": "123.456789",
"usd": "123.456789"
},
"volume": {
"native": "123.456789",
"usd": "123.456789"
}
},
"6h": {
"buyCount": 1,
"buyVolume": {
"native": "123.456789",
"usd": "123.456789"
},
"priceChangePct": "123.456789",
"sellCount": 1,
"sellVolume": {
"native": "123.456789",
"usd": "123.456789"
},
"volume": {
"native": "123.456789",
"usd": "123.456789"
}
}
},
"supply": "123.456789",
"symbol": "<string>",
"totals": {
"fees": {
"platform": {
"native": "123.456789",
"usd": "123.456789"
},
"transaction": {
"native": "123.456789",
"usd": "123.456789"
},
"validator": {
"native": "123.456789",
"usd": "123.456789"
},
"dex": {
"native": "123.456789",
"usd": "123.456789"
}
},
"volume": {
"native": "123.456789",
"usd": "123.456789"
}
},
"updatedAt": 123,
"anchorAddress": "<string>",
"anchorSymbol": "<string>",
"annotations": [
{
"kind": "mayhem_mode"
}
],
"bondingCurvePct": "123.456789",
"fees": {
"allocation": {
"kind": "holders_dividend",
"recipients": [
{
"address": "<string>",
"payoutAsset": {
"address": "<string>",
"symbol": "<string>"
},
"shareBps": 10000
}
]
},
"breakdown": [
{
"kind": "protocol_fee",
"asset": {
"address": "<string>",
"symbol": "<string>"
},
"buyBps": 0,
"buyBpsMax": 1000,
"sellBps": 100,
"sellBpsMax": 1000
}
],
"rewards": {
"minHolding": "123.456789",
"minHoldingUsd": "123.456789"
},
"totalBuyBps": 25,
"totalSellBps": 125
},
"graduatedAt": 123,
"graduatedToDex": "<string>",
"graduatedToPool": "<string>",
"launchpad": "<string>",
"logoUrl": "https://cdn.example.com/So11111111111111111111111111111111111111112.webp",
"platforms": [
{
"platform": "fomo"
}
],
"pools": [
{
"dex": "<string>",
"liquidity": {
"native": "123.456789",
"usd": "123.456789"
},
"pool": "<string>",
"quote": {
"address": "<string>",
"symbol": "<string>"
}
}
]
},
"rank": 1
}
]
}{
"error": {
"code": "UNAUTHORIZED",
"message": "<string>",
"details": "<unknown>"
}
}{
"error": {
"code": "UNAUTHORIZED",
"message": "<string>",
"details": "<unknown>"
}
}{
"error": {
"code": "UNAUTHORIZED",
"message": "<string>",
"details": "<unknown>"
}
}{
"error": {
"code": "UNAUTHORIZED",
"message": "<string>",
"details": "<unknown>"
}
}{
"error": {
"code": "UNAUTHORIZED",
"message": "<string>",
"details": "<unknown>"
}
}{
"error": {
"code": "UNAUTHORIZED",
"message": "<string>",
"details": "<unknown>"
}
}{
"error": {
"code": "UNAUTHORIZED",
"message": "<string>",
"details": "<unknown>"
}
}trending
Tokens ranked by trending score.
chains lists the chains to rank over, as one set. window sets the period the score covers,
and filters limits the tokens the board ranks. The score itself is not returned.
POST
/
v1
/
trending
Tokens ranked by trending score.
curl --request POST \
--url https://{host}/v1/trending \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"chains": [],
"filters": {
"ageMinutes": {
"max": 1,
"min": 1
},
"anchorSymbols": [
"<string>"
],
"bondingCurvePercent": {
"max": 123,
"min": 123
},
"bundlerSupplyPercent": {
"max": "123.456789",
"min": "123.456789"
},
"buys": {
"max": 1,
"min": 1
},
"devHoldingPercent": {
"max": 123,
"min": 123
},
"dexPaid": true,
"excludeAnnotations": [
{
"kind": "mayhem_mode"
}
],
"excludeDevAddresses": [
"<string>"
],
"excludeFundingAddresses": [
"<string>"
],
"excludeSymbolOrName": [
"<string>"
],
"excludeTwitter": [
"<string>"
],
"excludeWebsites": [
"<string>"
],
"globalFeesPaidNative": {
"max": "123.456789",
"min": "123.456789"
},
"globalFeesPaidUsd": {
"max": "123.456789",
"min": "123.456789"
},
"holderCount": {
"max": 1,
"min": 1
},
"insiderSupplyPercent": {
"max": "123.456789",
"min": "123.456789"
},
"lastActivityMinutes": 1,
"liquidityUsd": {
"max": "123.456789",
"min": "123.456789"
},
"marketCapUsd": {
"max": "123.456789",
"min": "123.456789"
},
"maxGraduationStaleMinutes": 1,
"proTraderCount": {
"max": 1,
"min": 1
},
"protocols": [
"<string>"
],
"sells": {
"max": 1,
"min": 1
},
"snipersSupplyPercent": {
"max": 123,
"min": 123
},
"symbolOrName": [
"<string>"
],
"top10HoldersPercent": {
"max": 123,
"min": 123
},
"twitterReuseCount": {
"max": 1,
"min": 1
},
"txns": {
"max": 1,
"min": 1
},
"volumeUsd": {
"max": "123.456789",
"min": "123.456789"
},
"withAtLeastOneSocial": true
},
"limit": 1
}
'import requests
url = "https://{host}/v1/trending"
payload = {
"chains": [],
"filters": {
"ageMinutes": {
"max": 1,
"min": 1
},
"anchorSymbols": ["<string>"],
"bondingCurvePercent": {
"max": 123,
"min": 123
},
"bundlerSupplyPercent": {
"max": "123.456789",
"min": "123.456789"
},
"buys": {
"max": 1,
"min": 1
},
"devHoldingPercent": {
"max": 123,
"min": 123
},
"dexPaid": True,
"excludeAnnotations": [{ "kind": "mayhem_mode" }],
"excludeDevAddresses": ["<string>"],
"excludeFundingAddresses": ["<string>"],
"excludeSymbolOrName": ["<string>"],
"excludeTwitter": ["<string>"],
"excludeWebsites": ["<string>"],
"globalFeesPaidNative": {
"max": "123.456789",
"min": "123.456789"
},
"globalFeesPaidUsd": {
"max": "123.456789",
"min": "123.456789"
},
"holderCount": {
"max": 1,
"min": 1
},
"insiderSupplyPercent": {
"max": "123.456789",
"min": "123.456789"
},
"lastActivityMinutes": 1,
"liquidityUsd": {
"max": "123.456789",
"min": "123.456789"
},
"marketCapUsd": {
"max": "123.456789",
"min": "123.456789"
},
"maxGraduationStaleMinutes": 1,
"proTraderCount": {
"max": 1,
"min": 1
},
"protocols": ["<string>"],
"sells": {
"max": 1,
"min": 1
},
"snipersSupplyPercent": {
"max": 123,
"min": 123
},
"symbolOrName": ["<string>"],
"top10HoldersPercent": {
"max": 123,
"min": 123
},
"twitterReuseCount": {
"max": 1,
"min": 1
},
"txns": {
"max": 1,
"min": 1
},
"volumeUsd": {
"max": "123.456789",
"min": "123.456789"
},
"withAtLeastOneSocial": True
},
"limit": 1
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
chains: [],
filters: {
ageMinutes: {max: 1, min: 1},
anchorSymbols: ['<string>'],
bondingCurvePercent: {max: 123, min: 123},
bundlerSupplyPercent: {max: '123.456789', min: '123.456789'},
buys: {max: 1, min: 1},
devHoldingPercent: {max: 123, min: 123},
dexPaid: true,
excludeAnnotations: [{kind: 'mayhem_mode'}],
excludeDevAddresses: ['<string>'],
excludeFundingAddresses: ['<string>'],
excludeSymbolOrName: ['<string>'],
excludeTwitter: ['<string>'],
excludeWebsites: ['<string>'],
globalFeesPaidNative: {max: '123.456789', min: '123.456789'},
globalFeesPaidUsd: {max: '123.456789', min: '123.456789'},
holderCount: {max: 1, min: 1},
insiderSupplyPercent: {max: '123.456789', min: '123.456789'},
lastActivityMinutes: 1,
liquidityUsd: {max: '123.456789', min: '123.456789'},
marketCapUsd: {max: '123.456789', min: '123.456789'},
maxGraduationStaleMinutes: 1,
proTraderCount: {max: 1, min: 1},
protocols: ['<string>'],
sells: {max: 1, min: 1},
snipersSupplyPercent: {max: 123, min: 123},
symbolOrName: ['<string>'],
top10HoldersPercent: {max: 123, min: 123},
twitterReuseCount: {max: 1, min: 1},
txns: {max: 1, min: 1},
volumeUsd: {max: '123.456789', min: '123.456789'},
withAtLeastOneSocial: true
},
limit: 1
})
};
fetch('https://{host}/v1/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://{host}/v1/trending",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'chains' => [
],
'filters' => [
'ageMinutes' => [
'max' => 1,
'min' => 1
],
'anchorSymbols' => [
'<string>'
],
'bondingCurvePercent' => [
'max' => 123,
'min' => 123
],
'bundlerSupplyPercent' => [
'max' => '123.456789',
'min' => '123.456789'
],
'buys' => [
'max' => 1,
'min' => 1
],
'devHoldingPercent' => [
'max' => 123,
'min' => 123
],
'dexPaid' => true,
'excludeAnnotations' => [
[
'kind' => 'mayhem_mode'
]
],
'excludeDevAddresses' => [
'<string>'
],
'excludeFundingAddresses' => [
'<string>'
],
'excludeSymbolOrName' => [
'<string>'
],
'excludeTwitter' => [
'<string>'
],
'excludeWebsites' => [
'<string>'
],
'globalFeesPaidNative' => [
'max' => '123.456789',
'min' => '123.456789'
],
'globalFeesPaidUsd' => [
'max' => '123.456789',
'min' => '123.456789'
],
'holderCount' => [
'max' => 1,
'min' => 1
],
'insiderSupplyPercent' => [
'max' => '123.456789',
'min' => '123.456789'
],
'lastActivityMinutes' => 1,
'liquidityUsd' => [
'max' => '123.456789',
'min' => '123.456789'
],
'marketCapUsd' => [
'max' => '123.456789',
'min' => '123.456789'
],
'maxGraduationStaleMinutes' => 1,
'proTraderCount' => [
'max' => 1,
'min' => 1
],
'protocols' => [
'<string>'
],
'sells' => [
'max' => 1,
'min' => 1
],
'snipersSupplyPercent' => [
'max' => 123,
'min' => 123
],
'symbolOrName' => [
'<string>'
],
'top10HoldersPercent' => [
'max' => 123,
'min' => 123
],
'twitterReuseCount' => [
'max' => 1,
'min' => 1
],
'txns' => [
'max' => 1,
'min' => 1
],
'volumeUsd' => [
'max' => '123.456789',
'min' => '123.456789'
],
'withAtLeastOneSocial' => true
],
'limit' => 1
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://{host}/v1/trending"
payload := strings.NewReader("{\n \"chains\": [],\n \"filters\": {\n \"ageMinutes\": {\n \"max\": 1,\n \"min\": 1\n },\n \"anchorSymbols\": [\n \"<string>\"\n ],\n \"bondingCurvePercent\": {\n \"max\": 123,\n \"min\": 123\n },\n \"bundlerSupplyPercent\": {\n \"max\": \"123.456789\",\n \"min\": \"123.456789\"\n },\n \"buys\": {\n \"max\": 1,\n \"min\": 1\n },\n \"devHoldingPercent\": {\n \"max\": 123,\n \"min\": 123\n },\n \"dexPaid\": true,\n \"excludeAnnotations\": [\n {\n \"kind\": \"mayhem_mode\"\n }\n ],\n \"excludeDevAddresses\": [\n \"<string>\"\n ],\n \"excludeFundingAddresses\": [\n \"<string>\"\n ],\n \"excludeSymbolOrName\": [\n \"<string>\"\n ],\n \"excludeTwitter\": [\n \"<string>\"\n ],\n \"excludeWebsites\": [\n \"<string>\"\n ],\n \"globalFeesPaidNative\": {\n \"max\": \"123.456789\",\n \"min\": \"123.456789\"\n },\n \"globalFeesPaidUsd\": {\n \"max\": \"123.456789\",\n \"min\": \"123.456789\"\n },\n \"holderCount\": {\n \"max\": 1,\n \"min\": 1\n },\n \"insiderSupplyPercent\": {\n \"max\": \"123.456789\",\n \"min\": \"123.456789\"\n },\n \"lastActivityMinutes\": 1,\n \"liquidityUsd\": {\n \"max\": \"123.456789\",\n \"min\": \"123.456789\"\n },\n \"marketCapUsd\": {\n \"max\": \"123.456789\",\n \"min\": \"123.456789\"\n },\n \"maxGraduationStaleMinutes\": 1,\n \"proTraderCount\": {\n \"max\": 1,\n \"min\": 1\n },\n \"protocols\": [\n \"<string>\"\n ],\n \"sells\": {\n \"max\": 1,\n \"min\": 1\n },\n \"snipersSupplyPercent\": {\n \"max\": 123,\n \"min\": 123\n },\n \"symbolOrName\": [\n \"<string>\"\n ],\n \"top10HoldersPercent\": {\n \"max\": 123,\n \"min\": 123\n },\n \"twitterReuseCount\": {\n \"max\": 1,\n \"min\": 1\n },\n \"txns\": {\n \"max\": 1,\n \"min\": 1\n },\n \"volumeUsd\": {\n \"max\": \"123.456789\",\n \"min\": \"123.456789\"\n },\n \"withAtLeastOneSocial\": true\n },\n \"limit\": 1\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://{host}/v1/trending")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"chains\": [],\n \"filters\": {\n \"ageMinutes\": {\n \"max\": 1,\n \"min\": 1\n },\n \"anchorSymbols\": [\n \"<string>\"\n ],\n \"bondingCurvePercent\": {\n \"max\": 123,\n \"min\": 123\n },\n \"bundlerSupplyPercent\": {\n \"max\": \"123.456789\",\n \"min\": \"123.456789\"\n },\n \"buys\": {\n \"max\": 1,\n \"min\": 1\n },\n \"devHoldingPercent\": {\n \"max\": 123,\n \"min\": 123\n },\n \"dexPaid\": true,\n \"excludeAnnotations\": [\n {\n \"kind\": \"mayhem_mode\"\n }\n ],\n \"excludeDevAddresses\": [\n \"<string>\"\n ],\n \"excludeFundingAddresses\": [\n \"<string>\"\n ],\n \"excludeSymbolOrName\": [\n \"<string>\"\n ],\n \"excludeTwitter\": [\n \"<string>\"\n ],\n \"excludeWebsites\": [\n \"<string>\"\n ],\n \"globalFeesPaidNative\": {\n \"max\": \"123.456789\",\n \"min\": \"123.456789\"\n },\n \"globalFeesPaidUsd\": {\n \"max\": \"123.456789\",\n \"min\": \"123.456789\"\n },\n \"holderCount\": {\n \"max\": 1,\n \"min\": 1\n },\n \"insiderSupplyPercent\": {\n \"max\": \"123.456789\",\n \"min\": \"123.456789\"\n },\n \"lastActivityMinutes\": 1,\n \"liquidityUsd\": {\n \"max\": \"123.456789\",\n \"min\": \"123.456789\"\n },\n \"marketCapUsd\": {\n \"max\": \"123.456789\",\n \"min\": \"123.456789\"\n },\n \"maxGraduationStaleMinutes\": 1,\n \"proTraderCount\": {\n \"max\": 1,\n \"min\": 1\n },\n \"protocols\": [\n \"<string>\"\n ],\n \"sells\": {\n \"max\": 1,\n \"min\": 1\n },\n \"snipersSupplyPercent\": {\n \"max\": 123,\n \"min\": 123\n },\n \"symbolOrName\": [\n \"<string>\"\n ],\n \"top10HoldersPercent\": {\n \"max\": 123,\n \"min\": 123\n },\n \"twitterReuseCount\": {\n \"max\": 1,\n \"min\": 1\n },\n \"txns\": {\n \"max\": 1,\n \"min\": 1\n },\n \"volumeUsd\": {\n \"max\": \"123.456789\",\n \"min\": \"123.456789\"\n },\n \"withAtLeastOneSocial\": true\n },\n \"limit\": 1\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://{host}/v1/trending")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"chains\": [],\n \"filters\": {\n \"ageMinutes\": {\n \"max\": 1,\n \"min\": 1\n },\n \"anchorSymbols\": [\n \"<string>\"\n ],\n \"bondingCurvePercent\": {\n \"max\": 123,\n \"min\": 123\n },\n \"bundlerSupplyPercent\": {\n \"max\": \"123.456789\",\n \"min\": \"123.456789\"\n },\n \"buys\": {\n \"max\": 1,\n \"min\": 1\n },\n \"devHoldingPercent\": {\n \"max\": 123,\n \"min\": 123\n },\n \"dexPaid\": true,\n \"excludeAnnotations\": [\n {\n \"kind\": \"mayhem_mode\"\n }\n ],\n \"excludeDevAddresses\": [\n \"<string>\"\n ],\n \"excludeFundingAddresses\": [\n \"<string>\"\n ],\n \"excludeSymbolOrName\": [\n \"<string>\"\n ],\n \"excludeTwitter\": [\n \"<string>\"\n ],\n \"excludeWebsites\": [\n \"<string>\"\n ],\n \"globalFeesPaidNative\": {\n \"max\": \"123.456789\",\n \"min\": \"123.456789\"\n },\n \"globalFeesPaidUsd\": {\n \"max\": \"123.456789\",\n \"min\": \"123.456789\"\n },\n \"holderCount\": {\n \"max\": 1,\n \"min\": 1\n },\n \"insiderSupplyPercent\": {\n \"max\": \"123.456789\",\n \"min\": \"123.456789\"\n },\n \"lastActivityMinutes\": 1,\n \"liquidityUsd\": {\n \"max\": \"123.456789\",\n \"min\": \"123.456789\"\n },\n \"marketCapUsd\": {\n \"max\": \"123.456789\",\n \"min\": \"123.456789\"\n },\n \"maxGraduationStaleMinutes\": 1,\n \"proTraderCount\": {\n \"max\": 1,\n \"min\": 1\n },\n \"protocols\": [\n \"<string>\"\n ],\n \"sells\": {\n \"max\": 1,\n \"min\": 1\n },\n \"snipersSupplyPercent\": {\n \"max\": 123,\n \"min\": 123\n },\n \"symbolOrName\": [\n \"<string>\"\n ],\n \"top10HoldersPercent\": {\n \"max\": 123,\n \"min\": 123\n },\n \"twitterReuseCount\": {\n \"max\": 1,\n \"min\": 1\n },\n \"txns\": {\n \"max\": 1,\n \"min\": 1\n },\n \"volumeUsd\": {\n \"max\": \"123.456789\",\n \"min\": \"123.456789\"\n },\n \"withAtLeastOneSocial\": true\n },\n \"limit\": 1\n}"
response = http.request(request)
puts response.read_body{
"deltas": [
{
"address": "<string>",
"chain": "solana",
"data": {
"address": "<string>",
"ath": {
"marketCap": {
"native": "123.456789",
"usd": "123.456789"
},
"marketCapAt": 123,
"price": {
"native": "123.456789",
"usd": "123.456789"
},
"priceAt": 123
},
"chain": "solana",
"createdAt": 123,
"creator": "<string>",
"decimals": 1,
"devFunding": {
"status": "unresolved",
"address": "<string>",
"sourceKind": "cex",
"sourceLabel": "<string>"
},
"dexes": [
"pumpswap",
"raydium"
],
"holders": {
"bundlerCount": 1,
"bundlerPct": "123.456789",
"count": 1,
"devPct": "123.456789",
"fomoCount": 1,
"fomoPct": "123.456789",
"freshWalletCount": 1,
"freshWalletPct": "123.456789",
"fundedByCexPct": "123.456789",
"insiderCount": 1,
"insiderPct": "123.456789",
"phishingCount": 1,
"phishingPct": "123.456789",
"proTraderCount": 1,
"proTraderPct": "123.456789",
"sniperCount": 1,
"sniperPct": "123.456789",
"top10Pct": "123.456789"
},
"liquidity": {
"native": "123.456789",
"usd": "123.456789"
},
"marketCap": {
"native": "123.456789",
"usd": "123.456789"
},
"metadata": {
"twitterReuseCount": 1,
"description": "<string>",
"discord": "<string>",
"telegram": "<string>",
"twitter": "<string>",
"website": "<string>"
},
"name": "<string>",
"price": {
"native": "123.456789",
"usd": "123.456789"
},
"security": {
"mintDisabled": true,
"rugPct": "123.456789",
"transferBlockable": true,
"buyTaxBps": 100,
"dividendMinHolding": "123.456789",
"dividendToken": "<string>",
"lpBurntPct": "123.456789",
"sellTaxBps": 200,
"totalBuyBps": 100,
"totalSellBps": 200,
"transferFeeBps": 250
},
"stats": {
"1h": {
"buyCount": 1,
"buyVolume": {
"native": "123.456789",
"usd": "123.456789"
},
"priceChangePct": "123.456789",
"sellCount": 1,
"sellVolume": {
"native": "123.456789",
"usd": "123.456789"
},
"volume": {
"native": "123.456789",
"usd": "123.456789"
}
},
"24h": {
"buyCount": 1,
"buyVolume": {
"native": "123.456789",
"usd": "123.456789"
},
"priceChangePct": "123.456789",
"sellCount": 1,
"sellVolume": {
"native": "123.456789",
"usd": "123.456789"
},
"volume": {
"native": "123.456789",
"usd": "123.456789"
}
},
"30m": {
"buyCount": 1,
"buyVolume": {
"native": "123.456789",
"usd": "123.456789"
},
"priceChangePct": "123.456789",
"sellCount": 1,
"sellVolume": {
"native": "123.456789",
"usd": "123.456789"
},
"volume": {
"native": "123.456789",
"usd": "123.456789"
}
},
"5m": {
"buyCount": 1,
"buyVolume": {
"native": "123.456789",
"usd": "123.456789"
},
"priceChangePct": "123.456789",
"sellCount": 1,
"sellVolume": {
"native": "123.456789",
"usd": "123.456789"
},
"volume": {
"native": "123.456789",
"usd": "123.456789"
}
},
"6h": {
"buyCount": 1,
"buyVolume": {
"native": "123.456789",
"usd": "123.456789"
},
"priceChangePct": "123.456789",
"sellCount": 1,
"sellVolume": {
"native": "123.456789",
"usd": "123.456789"
},
"volume": {
"native": "123.456789",
"usd": "123.456789"
}
}
},
"supply": "123.456789",
"symbol": "<string>",
"totals": {
"fees": {
"platform": {
"native": "123.456789",
"usd": "123.456789"
},
"transaction": {
"native": "123.456789",
"usd": "123.456789"
},
"validator": {
"native": "123.456789",
"usd": "123.456789"
},
"dex": {
"native": "123.456789",
"usd": "123.456789"
}
},
"volume": {
"native": "123.456789",
"usd": "123.456789"
}
},
"updatedAt": 123,
"anchorAddress": "<string>",
"anchorSymbol": "<string>",
"annotations": [
{
"kind": "mayhem_mode"
}
],
"bondingCurvePct": "123.456789",
"fees": {
"allocation": {
"kind": "holders_dividend",
"recipients": [
{
"address": "<string>",
"payoutAsset": {
"address": "<string>",
"symbol": "<string>"
},
"shareBps": 10000
}
]
},
"breakdown": [
{
"kind": "protocol_fee",
"asset": {
"address": "<string>",
"symbol": "<string>"
},
"buyBps": 0,
"buyBpsMax": 1000,
"sellBps": 100,
"sellBpsMax": 1000
}
],
"rewards": {
"minHolding": "123.456789",
"minHoldingUsd": "123.456789"
},
"totalBuyBps": 25,
"totalSellBps": 125
},
"graduatedAt": 123,
"graduatedToDex": "<string>",
"graduatedToPool": "<string>",
"launchpad": "<string>",
"logoUrl": "https://cdn.example.com/So11111111111111111111111111111111111111112.webp",
"platforms": [
{
"platform": "fomo"
}
],
"pools": [
{
"dex": "<string>",
"liquidity": {
"native": "123.456789",
"usd": "123.456789"
},
"pool": "<string>",
"quote": {
"address": "<string>",
"symbol": "<string>"
}
}
]
},
"rank": 1
}
]
}{
"error": {
"code": "UNAUTHORIZED",
"message": "<string>",
"details": "<unknown>"
}
}{
"error": {
"code": "UNAUTHORIZED",
"message": "<string>",
"details": "<unknown>"
}
}{
"error": {
"code": "UNAUTHORIZED",
"message": "<string>",
"details": "<unknown>"
}
}{
"error": {
"code": "UNAUTHORIZED",
"message": "<string>",
"details": "<unknown>"
}
}{
"error": {
"code": "UNAUTHORIZED",
"message": "<string>",
"details": "<unknown>"
}
}{
"error": {
"code": "UNAUTHORIZED",
"message": "<string>",
"details": "<unknown>"
}
}{
"error": {
"code": "UNAUTHORIZED",
"message": "<string>",
"details": "<unknown>"
}
}Authorizations
Send an API key, or a session token a key minted, as Authorization: Bearer <credential>. A browser opening /v1/stream offers its session token in Sec-WebSocket-Protocol instead.
Body
application/json
A trending board request: the chains, the window and the filters.
Chains to rank over, as one set. At least one is required.
Chain slug. One spelling per chain, in paths and bodies alike. Only a chain with spot data is published.
Available options:
solana, base, bsc, robinhood, arc Conditions every ranked token must match. Absent ranks every candidate.
Show child attributes
Show child attributes
Number of tokens on the board. The default is 100, and out-of-range values are clamped to 1–100.
Required range:
x >= 0Period the trending score covers. The default is 24h.
Available options:
5m, 30m, 1h, 6h, 24h Response
The ranked board, rank 1 first.
The trending board, rank 1 first.
One entry per rank.
Show child attributes
Show child attributes