Each named token's current holders, largest balance first, optionally narrowed to wallet
classifications.
curl --request GET \
--url https://{host}/v1/holders \
--header 'Authorization: Bearer <token>'import requests
url = "https://{host}/v1/holders"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://{host}/v1/holders', 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/holders",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$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://{host}/v1/holders"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://{host}/v1/holders")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://{host}/v1/holders")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body[
{
"address": "<string>",
"chain": "solana",
"hasMore": true,
"holderCount": 1,
"holders": [
{
"address": "<string>",
"balance": "123.456789",
"buyCount": 1,
"buyVolume": {
"native": "123.456789",
"usd": "123.456789"
},
"funding": {
"status": "unresolved",
"address": "<string>",
"amount": "123.456789",
"asset": "<string>",
"sourceKind": "cex",
"sourceLabel": "<string>",
"symbol": "<string>",
"timestamp": 123,
"tx": "<string>"
},
"realizedPnl": {
"native": "123.456789",
"usd": "123.456789"
},
"remainingPct": "123.456789",
"sellCount": 1,
"sellVolume": {
"native": "123.456789",
"usd": "123.456789"
},
"supplyPct": "123.456789",
"tokensBought": "123.456789",
"tokensSold": "123.456789",
"avgEntryMarketCap": {
"native": "123.456789",
"usd": "123.456789"
},
"avgEntryPrice": {
"native": "123.456789",
"usd": "123.456789"
},
"avgExitMarketCap": {
"native": "123.456789",
"usd": "123.456789"
},
"avgExitPrice": {
"native": "123.456789",
"usd": "123.456789"
},
"firstPurchaseAt": 123,
"flags": [
"bundler"
],
"identities": [
{
"source": "codex",
"avatar": "<string>",
"displayName": "<string>",
"farcaster": "<string>",
"handle": "<string>",
"telegram": "<string>",
"twitter": "<string>"
}
],
"nativeBalance": "123.456789",
"platforms": [
{
"platform": "fomo"
}
],
"rank": 1
}
],
"nextCursor": "<string>",
"top10": {
"avgEntryPrice": {
"native": "123.456789",
"usd": "123.456789"
},
"avgExitPrice": {
"native": "123.456789",
"usd": "123.456789"
}
}
}
]{
"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>"
}
}tokens
Each named token's current holders, largest balance first, optionally narrowed to wallet classifications.
tokens names 1 to 10 addresses, and each costs one credit. A token reads on every chain in
scope of its address family. Each chain that holds it answers one series, and a token no
chain in scope holds answers none. Pools and lockers rank here and carry their
flag. holderCount stays the token’s total under flags. limit sizes each series’ page,
and cursor reads a series’ next page. A holder whose balance changes between two pages can
move across the page boundary.
GET
/
v1
/
holders
Each named token's current holders, largest balance first, optionally narrowed to wallet
classifications.
curl --request GET \
--url https://{host}/v1/holders \
--header 'Authorization: Bearer <token>'import requests
url = "https://{host}/v1/holders"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://{host}/v1/holders', 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/holders",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$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://{host}/v1/holders"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://{host}/v1/holders")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://{host}/v1/holders")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body[
{
"address": "<string>",
"chain": "solana",
"hasMore": true,
"holderCount": 1,
"holders": [
{
"address": "<string>",
"balance": "123.456789",
"buyCount": 1,
"buyVolume": {
"native": "123.456789",
"usd": "123.456789"
},
"funding": {
"status": "unresolved",
"address": "<string>",
"amount": "123.456789",
"asset": "<string>",
"sourceKind": "cex",
"sourceLabel": "<string>",
"symbol": "<string>",
"timestamp": 123,
"tx": "<string>"
},
"realizedPnl": {
"native": "123.456789",
"usd": "123.456789"
},
"remainingPct": "123.456789",
"sellCount": 1,
"sellVolume": {
"native": "123.456789",
"usd": "123.456789"
},
"supplyPct": "123.456789",
"tokensBought": "123.456789",
"tokensSold": "123.456789",
"avgEntryMarketCap": {
"native": "123.456789",
"usd": "123.456789"
},
"avgEntryPrice": {
"native": "123.456789",
"usd": "123.456789"
},
"avgExitMarketCap": {
"native": "123.456789",
"usd": "123.456789"
},
"avgExitPrice": {
"native": "123.456789",
"usd": "123.456789"
},
"firstPurchaseAt": 123,
"flags": [
"bundler"
],
"identities": [
{
"source": "codex",
"avatar": "<string>",
"displayName": "<string>",
"farcaster": "<string>",
"handle": "<string>",
"telegram": "<string>",
"twitter": "<string>"
}
],
"nativeBalance": "123.456789",
"platforms": [
{
"platform": "fomo"
}
],
"rank": 1
}
],
"nextCursor": "<string>",
"top10": {
"avgEntryPrice": {
"native": "123.456789",
"usd": "123.456789"
},
"avgExitPrice": {
"native": "123.456789",
"usd": "123.456789"
}
}
}
]{
"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
Query Parameters
Response
One series per chain each named token trades on, in the order the request named them, each with one page of its current holders, largest balance first.