curl 'https://api.serialized.xyz/v1/token/holders?chain=evm:8453&address=0x4ed4e862860bed51a9570b96d89af5e1b0efefed&limit=2' -H 'Authorization: YOUR_API_KEY'
curl 'https://api.serialized.xyz/v1/token/holders?chain=evm:8453&address=0x4ed4e862860bed51a9570b96d89af5e1b0efefed&labels=sniper,bundler' -H 'Authorization: YOUR_API_KEY'
curl 'https://api.serialized.xyz/v1/token/holders?chain=solana&address=A7bdiYdS5GjqGFtxf17ppRHtDKPkkRqbKtR27dxvQXaS&watchlist=app-holders&limit=100' -H 'Authorization: YOUR_API_KEY'
curl 'https://api.serialized.xyz/v1/token/holders?chain=evm:8453&address=0x4ed4e862860bed51a9570b96d89af5e1b0efefed&limit=1000&cursor=NEXT_CURSOR_OF_THE_PREVIOUS_PAGE' -H 'Authorization: YOUR_API_KEY'
curl 'https://api.serialized.xyz/v1/token/holders?chain=solana&address=DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263&balanceMin=12345.666&balanceMax=12345.69' -H 'Authorization: YOUR_API_KEY'
curl 'https://api.serialized.xyz/v1/token/holders?chain=evm:8453&address=0x4ed4e862860bed51a9570b96d89af5e1b0efefed&wallets=0x06a19654e0872ba71c2261ea691ecf8a0c677156,0x82d4cd9bf16017fd518511d8bbe6d0493af31a10' -H 'Authorization: YOUR_API_KEY'
curl 'https://api.serialized.xyz/v1/token/holders?chain=evm:8453&address=0x4ed4e862860bed51a9570b96d89af5e1b0efefed&limit=1000&offset=1000' -H 'Authorization: YOUR_API_KEY'
{
"data": [
{
"rank": 1,
"address": "0x06a19654e0872ba71c2261ea691ecf8a0c677156",
"amountToken": 8135548469.70615,
"amount": "8135548469.706150214807131694",
"amountRaw": "8135548469706150214807131694",
"amountUsd": 7776959.864099269,
"pctSupply": 22.597112835144404,
"buys": null,
"sells": null,
"boughtTokens": null,
"soldTokens": null,
"firstTradeAt": null,
"lastTradeAt": null,
"volumeBuyUsd": null,
"volumeSellUsd": null,
"realizedPnlUsd": null,
"unrealizedPnlUsd": null,
"totalPnlUsd": null,
"boughtNative": null,
"soldNative": null,
"realizedPnlNative": null,
"unrealizedPnlNative": null,
"totalPnlNative": null,
"avgBuyPriceUsd": null,
"avgSellPriceUsd": null,
"entryPriceUsd": null,
"buyFeesUsd": null,
"sellFeesUsd": null,
"totalFeesUsd": null,
"labels": [],
"entityName": null,
"entityType": null,
"displayName": null,
"avatarUrl": null,
"twitter": null,
"platform": {
"id": "uniswap",
"name": "Uniswap",
"logo": "https://cdn.serialized.xyz/dex/platform-uniswap.c096b59c.png"
},
"fundingFrom": "0x3c12b77ae8b7dd1feb63d1d6a2a819acda0a41d2",
"fundingAt": 1719321763000,
"fundingTxHash": "0x5f1c0a4f6b1e2d8c9a7b3e4f5a6b7c8d9e0f1a2b3c4d5e6f7a8b9c0d1e2f3a4b",
"fundingAmountNative": "20000000000000000",
"fundingFromTag": null,
"fundingFromLogo": null
},
{
"rank": 2,
"address": "0x82d4cd9bf16017fd518511d8bbe6d0493af31a10",
"amountToken": 2023345890.1207378,
"amount": "2023345890.120737812048820613",
"amountRaw": "2023345890120737812048820613",
"amountUsd": 1934163.3618498424,
"pctSupply": 5.619999137591695,
"buys": 14,
"sells": 3,
"boughtTokens": "2100000000",
"soldTokens": "76654109.87926",
"firstTradeAt": 1716203411000,
"lastTradeAt": 1761821040000,
"volumeBuyUsd": 41250.12,
"volumeSellUsd": 3810.55,
"realizedPnlUsd": 2211.4,
"unrealizedPnlUsd": 1893372.9,
"totalPnlUsd": 1895584.3,
"boughtNative": 11.79,
"soldNative": 1.089,
"realizedPnlNative": 0.632,
"unrealizedPnlNative": 540.96,
"totalPnlNative": 541.592,
"avgBuyPriceUsd": 0.0000196,
"avgSellPriceUsd": 0.0000497,
"entryPriceUsd": 0.0000196,
"buyFeesUsd": null,
"sellFeesUsd": null,
"totalFeesUsd": null,
"labels": [],
"entityName": "Coinbase",
"entityType": null,
"displayName": "Coinbase",
"avatarUrl": null,
"twitter": null,
"platform": null,
"fundingFrom": "0x91d66b38ae24292e9e12dd962bbb3aecf4ab769a",
"fundingAt": 1770315221000,
"fundingTxHash": "0x8e3d2c1b0a9f8e7d6c5b4a39281706f5e4d3c2b1a0f9e8d7c6b5a4938271605f",
"fundingAmountNative": "1500000000000000",
"fundingFromTag": "Binance",
"fundingFromLogo": "https://pbs.twimg.com/profile_images/1840000000000000000/binance.jpg"
}
],
"meta": {
"asOf": 1792083596818,
"hasMore": true,
"totalHolders": 1193364,
"nextCursor": "eyJiIjoiMjAyMzM0NTg5MDEyMDczNzgxMjA0ODgyMDYxMyIsInciOiI4MmQ0Y2Q5YmYxNjAxN2ZkNTE4NTExZDhiYmU2ZDA0OTNhZjMxYTEwIiwiciI6MiwidCI6IktrQUFlbER1cWJyIn0"
}
}
Token Holders
Top holders with position size, share of supply, full PnL (realized + unrealized), buy/sell volumes, behavioral labels and named entities (exchanges, funds - the “Coinbase” signal), or the holders among one of your watchlists. EVM and Solana.
curl 'https://api.serialized.xyz/v1/token/holders?chain=evm:8453&address=0x4ed4e862860bed51a9570b96d89af5e1b0efefed&limit=2' -H 'Authorization: YOUR_API_KEY'
curl 'https://api.serialized.xyz/v1/token/holders?chain=evm:8453&address=0x4ed4e862860bed51a9570b96d89af5e1b0efefed&labels=sniper,bundler' -H 'Authorization: YOUR_API_KEY'
curl 'https://api.serialized.xyz/v1/token/holders?chain=solana&address=A7bdiYdS5GjqGFtxf17ppRHtDKPkkRqbKtR27dxvQXaS&watchlist=app-holders&limit=100' -H 'Authorization: YOUR_API_KEY'
curl 'https://api.serialized.xyz/v1/token/holders?chain=evm:8453&address=0x4ed4e862860bed51a9570b96d89af5e1b0efefed&limit=1000&cursor=NEXT_CURSOR_OF_THE_PREVIOUS_PAGE' -H 'Authorization: YOUR_API_KEY'
curl 'https://api.serialized.xyz/v1/token/holders?chain=solana&address=DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263&balanceMin=12345.666&balanceMax=12345.69' -H 'Authorization: YOUR_API_KEY'
curl 'https://api.serialized.xyz/v1/token/holders?chain=evm:8453&address=0x4ed4e862860bed51a9570b96d89af5e1b0efefed&wallets=0x06a19654e0872ba71c2261ea691ecf8a0c677156,0x82d4cd9bf16017fd518511d8bbe6d0493af31a10' -H 'Authorization: YOUR_API_KEY'
curl 'https://api.serialized.xyz/v1/token/holders?chain=evm:8453&address=0x4ed4e862860bed51a9570b96d89af5e1b0efefed&limit=1000&offset=1000' -H 'Authorization: YOUR_API_KEY'
{
"data": [
{
"rank": 1,
"address": "0x06a19654e0872ba71c2261ea691ecf8a0c677156",
"amountToken": 8135548469.70615,
"amount": "8135548469.706150214807131694",
"amountRaw": "8135548469706150214807131694",
"amountUsd": 7776959.864099269,
"pctSupply": 22.597112835144404,
"buys": null,
"sells": null,
"boughtTokens": null,
"soldTokens": null,
"firstTradeAt": null,
"lastTradeAt": null,
"volumeBuyUsd": null,
"volumeSellUsd": null,
"realizedPnlUsd": null,
"unrealizedPnlUsd": null,
"totalPnlUsd": null,
"boughtNative": null,
"soldNative": null,
"realizedPnlNative": null,
"unrealizedPnlNative": null,
"totalPnlNative": null,
"avgBuyPriceUsd": null,
"avgSellPriceUsd": null,
"entryPriceUsd": null,
"buyFeesUsd": null,
"sellFeesUsd": null,
"totalFeesUsd": null,
"labels": [],
"entityName": null,
"entityType": null,
"displayName": null,
"avatarUrl": null,
"twitter": null,
"platform": {
"id": "uniswap",
"name": "Uniswap",
"logo": "https://cdn.serialized.xyz/dex/platform-uniswap.c096b59c.png"
},
"fundingFrom": "0x3c12b77ae8b7dd1feb63d1d6a2a819acda0a41d2",
"fundingAt": 1719321763000,
"fundingTxHash": "0x5f1c0a4f6b1e2d8c9a7b3e4f5a6b7c8d9e0f1a2b3c4d5e6f7a8b9c0d1e2f3a4b",
"fundingAmountNative": "20000000000000000",
"fundingFromTag": null,
"fundingFromLogo": null
},
{
"rank": 2,
"address": "0x82d4cd9bf16017fd518511d8bbe6d0493af31a10",
"amountToken": 2023345890.1207378,
"amount": "2023345890.120737812048820613",
"amountRaw": "2023345890120737812048820613",
"amountUsd": 1934163.3618498424,
"pctSupply": 5.619999137591695,
"buys": 14,
"sells": 3,
"boughtTokens": "2100000000",
"soldTokens": "76654109.87926",
"firstTradeAt": 1716203411000,
"lastTradeAt": 1761821040000,
"volumeBuyUsd": 41250.12,
"volumeSellUsd": 3810.55,
"realizedPnlUsd": 2211.4,
"unrealizedPnlUsd": 1893372.9,
"totalPnlUsd": 1895584.3,
"boughtNative": 11.79,
"soldNative": 1.089,
"realizedPnlNative": 0.632,
"unrealizedPnlNative": 540.96,
"totalPnlNative": 541.592,
"avgBuyPriceUsd": 0.0000196,
"avgSellPriceUsd": 0.0000497,
"entryPriceUsd": 0.0000196,
"buyFeesUsd": null,
"sellFeesUsd": null,
"totalFeesUsd": null,
"labels": [],
"entityName": "Coinbase",
"entityType": null,
"displayName": "Coinbase",
"avatarUrl": null,
"twitter": null,
"platform": null,
"fundingFrom": "0x91d66b38ae24292e9e12dd962bbb3aecf4ab769a",
"fundingAt": 1770315221000,
"fundingTxHash": "0x8e3d2c1b0a9f8e7d6c5b4a39281706f5e4d3c2b1a0f9e8d7c6b5a4938271605f",
"fundingAmountNative": "1500000000000000",
"fundingFromTag": "Binance",
"fundingFromLogo": "https://pbs.twimg.com/profile_images/1840000000000000000/binance.jpg"
}
],
"meta": {
"asOf": 1792083596818,
"hasMore": true,
"totalHolders": 1193364,
"nextCursor": "eyJiIjoiMjAyMzM0NTg5MDEyMDczNzgxMjA0ODgyMDYxMyIsInciOiI4MmQ0Y2Q5YmYxNjAxN2ZkNTE4NTExZDhiYmU2ZDA0OTNhZjMxYTEwIiwiciI6MiwidCI6IktrQUFlbER1cWJyIn0"
}
}
GET /v1/token/holders · 2 credits per call, whatever the page size
Top holders with position size, share of supply, full PnL (realized + unrealized), buy/sell volumes, behavioral labels and named entities (exchanges, funds - the “Coinbase” signal). EVM and Solana.
limit (1 to 1000, default 50) is the page size and offset (default 0) the number of holders to skip: offset=1000&limit=1000 is holders 1001 to 2000. With offset, the list goes down to the 5 000th holder (offset + limit ≤ 5000), and to the last one with watchlist (then limit is at most 100). rank is absolute across pages (with watchlist, see below when it is known) and meta.hasMore tells whether a next page exists within that depth.meta.nextCursor: pass it back as cursor (with the same or another limit, without offset) to get the holders right after that page, at any depth, past the 5 000th holder too, at the same cost per page. meta.nextCursor is null after the last holder. Ranks keep counting from the cursor; when balances move between two calls, a holder can shift by a few ranks, as with offset. cursor does not combine with labels, watchlist or wallets. A cursor is valid for the token, chain and balance filter that gave it: on another one it returns 400. On EVM chains, stablecoins and wrapped native coins have no cursor (400): page them with offset. Deep in the list, where a very large number of wallets hold exactly the same balance (dust, airdrops), a page can return a retryable 503 instead of a slow answer.balanceMin and balanceMax keep the holders whose balance is inside a range, bounds included, in token units as plain decimal numbers (balanceMin=12345.666&balanceMax=12345.69), searched among all holders of the token, small balances included: finding a wallet from its exact holding takes one call instead of paging the whole list. Send one bound or both. The holders come largest balance first, limit per page, and meta.nextCursor gives the next page (pass it back as cursor with the same bounds; offset is not accepted). With balanceMax, rank is null; with balanceMin alone it is the rank among all holders. The filter matches current balances and does not combine with labels, watchlist or wallets. On EVM chains, stablecoins and wrapped native coins cannot be filtered by balance (400).wallets (comma-separated or a list, at most 100 addresses) keeps the holders among these wallets, without creating a watchlist: first the ones that hold the token, largest balance first, then the ones that traded it and hold none of it any more, latest trade first. The wallets that exited come with a zero balance (amount and amountRaw "0", amountToken 0) and the same trading, funding, label and identity fields as a holder; their unrealized PnL is 0 and their entryPriceUsd null, since they hold nothing. Every row has rank null. meta.matched is how many of the wallets hold the token and meta.exited how many traded it and hold none. A wallet that never traded the token is not returned, including one that only received it and sent it on by transfer. On Solana, for reference quote assets (USDC, USDT, liquid staking tokens), only holders are returned. It combines with labels (both must match, on holders and wallets that exited alike), not with watchlist or cursor; offset and limit page the whole list, holders first. An unknown token returns 404, as without the filter. Same price, 2 credits; it counts against the Watchlist holders rate group, like watchlist.amount is the balance as a decimal string at the token’s full precision, never in exponent notation (the format of amount on /v1/wallet/positions); amountToken is the same balance as a number and amountRaw the raw balance in the token’s smallest units, as a string.boughtTokens and soldTokens are the token amounts the holder bought and sold by swap (decimal strings), firstTradeAt and lastTradeAt its first and last swap of this token (ms). buyFeesUsd, sellFeesUsd and totalFeesUsd are the fees it paid on those swaps (network, priority tips and trading platform fees), on Solana for positions opened since 2026-09-15; null on EVM chains and on older positions. fundingTxHash and fundingAmountNative (raw native units: wei, lamports) complete fundingFrom and fundingAt, the wallet’s first funding; fundingFromTag and fundingFromLogo name the funder and give its logo when it is a known entity (an exchange, a bridge: the funderTag of /v1/wallet/funding), null otherwise.boughtNative, soldNative, realizedPnlNative, unrealizedPnlNative and totalPnlNative are the same figures in the chain’s native coin (ETH, BNB, SOL…), with the names of /v1/token/top-traders: bought and sold, realized PnL, the unrealized PnL of the tokens the holder still holds at the current price, and their sum. No exchange rate is involved. null when the wallet’s trading history on this token is unknown, and unrealizedPnlNative and totalPnlNative while the token has no price.meta.totalHolders carries the token’s full holder count; meta.asOf is the moment the list was computed.400 INVALID_PARAM on every chain (0x0000…0000 on EVM, the SOL mint on Solana). A wallet’s native balance is in /v1/wallet/positions.entryPriceUsd is the entry price of the tokens the holder still holds, with the definition of entryPriceUsd on /v1/wallet/positions: after a full exit, the next buys start a new entry price. avgBuyPriceUsd is the average price of every buy of the wallet on this token. entryPriceUsd is null when nothing the holder still holds was bought, for instance a balance received by transfer.buys, sells, boughtTokens, soldTokens, firstTradeAt, lastTradeAt, volumeBuyUsd, volumeSellUsd, realizedPnlUsd, unrealizedPnlUsd, totalPnlUsd, avgBuyPriceUsd, avgSellPriceUsd, entryPriceUsd, and their native twins) are null when the wallet’s trading history on this token is unknown, for instance a holder that received the token by transfer, and on Solana reference quote assets (USDC, USDT, liquid staking tokens), which holders trade as the quote side: never a fabricated zero.entityName names known entities (exchanges, funds, protocols) and entityType their kind (cex, protocol, bridge…); neither is ever set on the token’s pools. displayName, avatarUrl and twitter (the X handle, without @) are the wallet’s public profile, as /v1/wallet/profile serves it: a KOL’s name and handle, an ENS or Basename, a Farcaster or Pump.fun profile. Each is null when unknown.platform is the trading platform the wallet trades with (a terminal, bot, wallet app, aggregator, DEX router or launchpad app), the same object as /v1/wallet/labels: id (a stable lowercase identifier such as axiom, gmgn, trojan, uniswap), name and logo (an https URL, null when we host no logo for that platform). platform is null when not known.labels lists the holder’s wallet labels as they stand now (dev, sniper, bundler, whale, proTrader, smartTrader, freshTrader, kol, insider, then liquidityPool for the token’s pools and liquidity custody, on Solana also the Pump.fun Mayhem agent and the token’s price pool). insider (Solana) marks a wallet that received at least 0.01 % of the supply in one transfer without buying it, for tokens created since 2026-10-02. On Solana, pctSupply is the holder’s share of the sum of all balances of the token, the supply that the label shares of /v1/token/security divide by (its total supply for SOL and the stablecoins and quote tokens kept out of wallet labels). Burn addresses are never listed.watchlist (the id of one of your watchlists) keeps the holders that are in it, searched among all the token’s holders, small balances included: the holders tab of your own users. Rows and order are the same; rank is the holder’s rank among all holders of the token when the token has no more holders than your watchlist has wallets on the chain (and at most 50,000), and always with labels; null otherwise. limit is at most 100 and offset can go past 5 000 (up to 500,000). It combines with labels (both must match; labels are searched among the token’s top 5 000 holders, as without watchlist). The response carries meta.watchlist (id, version, wallets): a change to the watchlist can take a few seconds to show up, version is the one the page reflects and wallets the watchlist’s size at that version. Same price, 2 credits per call. A filtered call counts 1 against its own rate group, Watchlist holders (120 calls per minute per key by default, raised on request), whatever its limit, and never against the Wallet group; the X-RateLimit-Group-* headers of every response show what is left (rate limits). On EVM chains, stablecoins and wrapped native coins return 400 with watchlist; an unknown or purged watchlist returns 404.labels (comma-separated or a list, any of them matches) keeps the holders carrying at least one of the requested labels, searched among the top 5 000 holders. Each holder keeps its rank among all holders; offset and limit page the filtered list, and meta.hasMore tells whether more matching holders follow. The response carries meta.labelBasis (current) and meta.labelCoverage. insider is served on Solana only: on EVM chains, labels=insider returns 400.curl 'https://api.serialized.xyz/v1/token/holders?chain=evm:8453&address=0x4ed4e862860bed51a9570b96d89af5e1b0efefed&limit=2' -H 'Authorization: YOUR_API_KEY'
curl 'https://api.serialized.xyz/v1/token/holders?chain=evm:8453&address=0x4ed4e862860bed51a9570b96d89af5e1b0efefed&labels=sniper,bundler' -H 'Authorization: YOUR_API_KEY'
curl 'https://api.serialized.xyz/v1/token/holders?chain=solana&address=A7bdiYdS5GjqGFtxf17ppRHtDKPkkRqbKtR27dxvQXaS&watchlist=app-holders&limit=100' -H 'Authorization: YOUR_API_KEY'
curl 'https://api.serialized.xyz/v1/token/holders?chain=evm:8453&address=0x4ed4e862860bed51a9570b96d89af5e1b0efefed&limit=1000&cursor=NEXT_CURSOR_OF_THE_PREVIOUS_PAGE' -H 'Authorization: YOUR_API_KEY'
curl 'https://api.serialized.xyz/v1/token/holders?chain=solana&address=DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263&balanceMin=12345.666&balanceMax=12345.69' -H 'Authorization: YOUR_API_KEY'
curl 'https://api.serialized.xyz/v1/token/holders?chain=evm:8453&address=0x4ed4e862860bed51a9570b96d89af5e1b0efefed&wallets=0x06a19654e0872ba71c2261ea691ecf8a0c677156,0x82d4cd9bf16017fd518511d8bbe6d0493af31a10' -H 'Authorization: YOUR_API_KEY'
curl 'https://api.serialized.xyz/v1/token/holders?chain=evm:8453&address=0x4ed4e862860bed51a9570b96d89af5e1b0efefed&limit=1000&offset=1000' -H 'Authorization: YOUR_API_KEY'
{
"data": [
{
"rank": 1,
"address": "0x06a19654e0872ba71c2261ea691ecf8a0c677156",
"amountToken": 8135548469.70615,
"amount": "8135548469.706150214807131694",
"amountRaw": "8135548469706150214807131694",
"amountUsd": 7776959.864099269,
"pctSupply": 22.597112835144404,
"buys": null,
"sells": null,
"boughtTokens": null,
"soldTokens": null,
"firstTradeAt": null,
"lastTradeAt": null,
"volumeBuyUsd": null,
"volumeSellUsd": null,
"realizedPnlUsd": null,
"unrealizedPnlUsd": null,
"totalPnlUsd": null,
"boughtNative": null,
"soldNative": null,
"realizedPnlNative": null,
"unrealizedPnlNative": null,
"totalPnlNative": null,
"avgBuyPriceUsd": null,
"avgSellPriceUsd": null,
"entryPriceUsd": null,
"buyFeesUsd": null,
"sellFeesUsd": null,
"totalFeesUsd": null,
"labels": [],
"entityName": null,
"entityType": null,
"displayName": null,
"avatarUrl": null,
"twitter": null,
"platform": {
"id": "uniswap",
"name": "Uniswap",
"logo": "https://cdn.serialized.xyz/dex/platform-uniswap.c096b59c.png"
},
"fundingFrom": "0x3c12b77ae8b7dd1feb63d1d6a2a819acda0a41d2",
"fundingAt": 1719321763000,
"fundingTxHash": "0x5f1c0a4f6b1e2d8c9a7b3e4f5a6b7c8d9e0f1a2b3c4d5e6f7a8b9c0d1e2f3a4b",
"fundingAmountNative": "20000000000000000",
"fundingFromTag": null,
"fundingFromLogo": null
},
{
"rank": 2,
"address": "0x82d4cd9bf16017fd518511d8bbe6d0493af31a10",
"amountToken": 2023345890.1207378,
"amount": "2023345890.120737812048820613",
"amountRaw": "2023345890120737812048820613",
"amountUsd": 1934163.3618498424,
"pctSupply": 5.619999137591695,
"buys": 14,
"sells": 3,
"boughtTokens": "2100000000",
"soldTokens": "76654109.87926",
"firstTradeAt": 1716203411000,
"lastTradeAt": 1761821040000,
"volumeBuyUsd": 41250.12,
"volumeSellUsd": 3810.55,
"realizedPnlUsd": 2211.4,
"unrealizedPnlUsd": 1893372.9,
"totalPnlUsd": 1895584.3,
"boughtNative": 11.79,
"soldNative": 1.089,
"realizedPnlNative": 0.632,
"unrealizedPnlNative": 540.96,
"totalPnlNative": 541.592,
"avgBuyPriceUsd": 0.0000196,
"avgSellPriceUsd": 0.0000497,
"entryPriceUsd": 0.0000196,
"buyFeesUsd": null,
"sellFeesUsd": null,
"totalFeesUsd": null,
"labels": [],
"entityName": "Coinbase",
"entityType": null,
"displayName": "Coinbase",
"avatarUrl": null,
"twitter": null,
"platform": null,
"fundingFrom": "0x91d66b38ae24292e9e12dd962bbb3aecf4ab769a",
"fundingAt": 1770315221000,
"fundingTxHash": "0x8e3d2c1b0a9f8e7d6c5b4a39281706f5e4d3c2b1a0f9e8d7c6b5a4938271605f",
"fundingAmountNative": "1500000000000000",
"fundingFromTag": "Binance",
"fundingFromLogo": "https://pbs.twimg.com/profile_images/1840000000000000000/binance.jpg"
}
],
"meta": {
"asOf": 1792083596818,
"hasMore": true,
"totalHolders": 1193364,
"nextCursor": "eyJiIjoiMjAyMzM0NTg5MDEyMDczNzgxMjA0ODgyMDYxMyIsInciOiI4MmQ0Y2Q5YmYxNjAxN2ZkNTE4NTExZDhiYmU2ZDA0OTNhZjMxYTEwIiwiciI6MiwidCI6IktrQUFlbER1cWJyIn0"
}
}
Query Parameters
Keep only the holders carrying at least one of these labels, comma-separated or as a list: dev, sniper, bundler, whale, proTrader, smartTrader, freshTrader, kol, insider (Solana only), liquidityPool. Searched among the top 5000 holders, with or without watchlist; each holder keeps its rank among all holders, and offset and limit page the filtered list.
The id of one of your watchlists (/v1/wallet/watchlist): keep only its wallets, searched among all the token's holders. rank is the holder's rank among all holders of the token when the token has no more holders than your watchlist has wallets on the chain (and at most 50,000), and always with labels; null otherwise; meta.watchlist carries id, version and wallets (the watchlist's size at that version). Combines with labels (both must match; labels are searched among the token's top 5000 holders, as without watchlist).
Keep only these wallets, comma-separated or as a list (at most 100): the ones that hold the token, by balance, then the ones that traded it and hold none of it any more (amount 0, latest trade first), rank null. meta.matched counts the holders, meta.exited the others. Not with watchlist or cursor.
Response
Standard { data, meta } envelope.