curl 'https://api.serialized.xyz/v1/token/security?chain=solana&address=DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263' \
-H 'Authorization: YOUR_API_KEY'
{
"data": {
"chain": "solana",
"address": "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
"tokenAddress": "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
"poolAddress": "5zpyutJu9ee6jFymDGoK7F6S5Kczqtc9FomP3ueKuyA9",
"holdersCount": 892341,
"holdersAsOf": null,
"top10HoldersPct": 24.83,
"top25HoldersPct": 37.95,
"top50HoldersPct": 48.6,
"top100HoldersPct": 59.12,
"top200HoldersPct": 70.4,
"devHoldingsPct": 0,
"snipersHoldingsPct": 0,
"bundlersHoldingsPct": null,
"snipersCount": 0,
"bundlersCount": null,
"insidersHoldingsPct": null,
"insidersCount": null,
"proTradersCount": 1388,
"proTradersHoldingsPct": 0.107,
"whalesCount": null,
"whalesHoldingsPct": null,
"freshTradersCount": null,
"freshTradersHoldingsPct": null,
"smartTradersCount": 111,
"smartTradersHoldingsPct": 0.032,
"kolsCount": 96,
"kolsHoldingsPct": 0.005,
"snipersAllTimeCount": 1,
"bundlersAllTimeCount": null,
"whalesAllTimeCount": null,
"insidersAllTimeCount": null,
"freshTradersAllTimeCount": null,
"proTradersAllTimeCount": 28606,
"smartTradersAllTimeCount": 627,
"kolsAllTimeCount": 999,
"tokenBurnedPct": null,
"lpBurnedPct": null,
"lpLockedPct": null,
"lpSource": "unknown",
"dexPaid": true,
"dexPaidAt": 1740046431000,
"buyTaxBps": 0,
"sellTaxBps": 0,
"transferTaxBps": 0,
"modifiableTax": false,
"isHoneypot": false,
"mintAuthority": null,
"mintRevoked": true,
"freezeAuthority": null,
"freezeRevoked": true,
"isToken2022": false,
"transferPausable": false,
"isPaused": false,
"balanceMutable": false,
"permanentDelegate": null,
"transferHookProgram": null,
"closeAuthority": null,
"renounced": null,
"isProxy": null,
"implementationAddress": null,
"isMintable": null,
"isBlacklisted": null,
"isNotOpenSource": null,
"selfDestruct": null,
"upgradeableProxy": null
},
"meta": {
"asOf": 1786777912344
}
}
Token Security
Security fields for any token in one union shape: mint/freeze authority state, holders count, top 10 to top 200 concentration (on EVM, liquidity pools, burn wallets, CEX custody and launchpad lockers set aside; on Solana, liquidity pools, the mint, burn wallets and the Pump.fun Mayhem agent set aside, then the price pool and known entities), dev holdings %, eight wallet labels (snipers, bundlers, whales, insiders, fresh, pro and smart traders, KOLs: holding now, % of supply held, all-time count), token burn, LP burn/lock, buy/sell/transfer tax, honeypot, dexPaid + dexPaidAt; contract flags (mintable, pausable, blacklist, mutable balances, modifiable tax, self-destruct, unverified source), ownership renounced and upgradeable proxy on EVM; Token-2022 controls on Solana. null always means unknown, never a fake zero.
curl 'https://api.serialized.xyz/v1/token/security?chain=solana&address=DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263' \
-H 'Authorization: YOUR_API_KEY'
{
"data": {
"chain": "solana",
"address": "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
"tokenAddress": "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
"poolAddress": "5zpyutJu9ee6jFymDGoK7F6S5Kczqtc9FomP3ueKuyA9",
"holdersCount": 892341,
"holdersAsOf": null,
"top10HoldersPct": 24.83,
"top25HoldersPct": 37.95,
"top50HoldersPct": 48.6,
"top100HoldersPct": 59.12,
"top200HoldersPct": 70.4,
"devHoldingsPct": 0,
"snipersHoldingsPct": 0,
"bundlersHoldingsPct": null,
"snipersCount": 0,
"bundlersCount": null,
"insidersHoldingsPct": null,
"insidersCount": null,
"proTradersCount": 1388,
"proTradersHoldingsPct": 0.107,
"whalesCount": null,
"whalesHoldingsPct": null,
"freshTradersCount": null,
"freshTradersHoldingsPct": null,
"smartTradersCount": 111,
"smartTradersHoldingsPct": 0.032,
"kolsCount": 96,
"kolsHoldingsPct": 0.005,
"snipersAllTimeCount": 1,
"bundlersAllTimeCount": null,
"whalesAllTimeCount": null,
"insidersAllTimeCount": null,
"freshTradersAllTimeCount": null,
"proTradersAllTimeCount": 28606,
"smartTradersAllTimeCount": 627,
"kolsAllTimeCount": 999,
"tokenBurnedPct": null,
"lpBurnedPct": null,
"lpLockedPct": null,
"lpSource": "unknown",
"dexPaid": true,
"dexPaidAt": 1740046431000,
"buyTaxBps": 0,
"sellTaxBps": 0,
"transferTaxBps": 0,
"modifiableTax": false,
"isHoneypot": false,
"mintAuthority": null,
"mintRevoked": true,
"freezeAuthority": null,
"freezeRevoked": true,
"isToken2022": false,
"transferPausable": false,
"isPaused": false,
"balanceMutable": false,
"permanentDelegate": null,
"transferHookProgram": null,
"closeAuthority": null,
"renounced": null,
"isProxy": null,
"implementationAddress": null,
"isMintable": null,
"isBlacklisted": null,
"isNotOpenSource": null,
"selfDestruct": null,
"upgradeableProxy": null
},
"meta": {
"asOf": 1786777912344
}
}
GET /v1/token/security · 10 credits
Everything you need to screen a token before trading it, in one call and one shape across EVM and Solana:
- Authorities -
mintAuthority/mintRevoked,freezeAuthority/freezeRevoked: an active mint or freeze authority is the classic honeypot flag. - Concentration -
holdersCount(withholdersAsOf, the day of the figure when it is a snapshot: stablecoins and wrapped native coins on EVM chains,nullwhen the count is live), and the shares of supply held by the largest holders:top10HoldersPct,top25HoldersPct,top50HoldersPct,top100HoldersPctandtop200HoldersPct(on EVM, liquidity pools, burn wallets, CEX custody and launchpad lockers set aside; on Solana, liquidity pools, the mint, burn wallets and the Pump.fun Mayhem agent set aside, then the price pool and known entities: the exclusion is the signal; on EVMnullwhen it cannot be measured exactly, never a partial sum; on Solana see the concentration note below),devHoldingsPct. - Launch quality -
snipersCount/snipersHoldingsPctandbundlersCount/bundlersHoldingsPct: the sniper and bundler wallets still holding the token and the share of supply they hold;tokenBurnedPct(the share of supply sitting in burn addresses, on EVM and Solana). - Holder profile -
insidersCount/insidersHoldingsPctandproTradersCount/proTradersHoldingsPct: insiders and pro traders among the current holders, and the share of supply they hold. - Wallet labels (Solana) - eight labels, each with three fields:
<label>Count(wallets holding the token now),<label>HoldingsPct(the share of supply they hold) and<label>AllTimeCount(every wallet that ever carried the label on this token, sellers included), forsnipers,bundlers,whales,insiders,freshTraders,proTraders,smartTradersandkols. - Liquidity safety -
lpBurnedPct,lpLockedPct,lpSource. - Taxes & listing -
buyTaxBps,sellTaxBps,transferTaxBps,modifiableTax,isHoneypot,dexPaid,dexPaidAt(the DEX Screener listing status, resolved from its listing records when our index has no record). - Contract control (EVM) -
renounced,isProxy,implementationAddress, and the contract flagsisMintable,transferPausable,isBlacklisted,balanceMutable,modifiableTax,selfDestruct,upgradeableProxy,isNotOpenSource. - Token-2022 controls (Solana) -
isToken2022,transferPausable,isPaused,balanceMutable,permanentDelegate,transferHookProgram,closeAuthority.
null always means unknown, never a fabricated zero or false.
GET /v1/token and its batch with include=security return them in a tokenSecurity block, with the same names and values, for 2 more credits per call. This endpoint keeps the tops 25 to 200, the eight wallet labels with their all-time counts, the pro traders holding the token, tokenBurnedPct and holdersAsOf.top10HoldersPct to top200HoldersPct are the shares of supply (0-100) held by the 10, 25, 50, 100 and 200 largest holders. On EVM, with liquidity pools, burn wallets, CEX custody and launchpad lockers set aside, each depth is null when too many of the largest wallets are set aside to measure it exactly, never a partial sum. On Solana, the five shares follow the rule of our token statistics (the largest holders read in order, liquidity pools, the mint, burn wallets and the Pump.fun Mayhem agent set aside, then the price pool and known entities), and every share of this sheet (devHoldingsPct, tokenBurnedPct and the labels included) is a share of the sum of all the token’s balances: a token with fewer holders than the depth counts all of them; the shares are taken from a fixed window of the largest remaining holders (70 for the top 10 to top 50, 220 for the top 100 and top 200), so a share can read low when many of them are set aside, never null for that reason; and they are null for wrapped SOL and for the stablecoins and quote tokens kept out of wallet labels (USDC, USDT, USDG, EURC and similar), whether they trade or not. top10HoldersPct is also on GET /v1/token, with the same figure, and top10HoldersPct, top25HoldersPct and top50HoldersPct on the Pulse, Screener and search rows and their streams, with the same figures.- Snipers are wallets that bought in the first blocks (Solana: slots) after launch.
snipersCountis the number of them still holding the token,snipersHoldingsPctthe share of supply they still hold from their launch buys (0-100). - Bundlers are, on EVM, wallets that bought at least twice within the launch window; on Solana, wallets that bought in a launch bundle (a buy transaction shared by several signing wallets in the token’s first slots, or the bundle of its creation).
bundlersCountis the number of them still holding the token,bundlersHoldingsPctthe share of supply they hold (0-100). - Counts and shares follow current balances: a wallet that sold or moved its tokens out no longer counts. The token’s creator never counts here, its holdings are
devHoldingsPct. A wallet can be both a sniper and a bundler.0means none detected;nullmeans the figure cannot be measured exactly for this token.
- Insiders are wallets linked to the token’s team or creator.
insidersCountis the number of insiders holding the token (on EVM, among its main holders),insidersHoldingsPctthe share of supply they hold (0-100). On Solana, the insider label of the wallet labels below. - Pro traders are wallets that have traded $50,000 or more through professional trading terminals (the
proTraderwallet label).proTradersCountis the number of them currently holding the token,proTradersHoldingsPctthe share of supply they hold (0-100), from their current balances (on EVM, with the exclusions oftop10HoldersPct: liquidity pools, burn wallets, CEX custody and launchpad lockers set aside). - A wallet can be both an insider and a pro trader.
0means none detected;nullmeans the figure cannot be measured exactly for this token.
null on EVM, except the snipers, bundlers, insiders and pro traders holding the token, served on both families):- Snipers bought in the first slots after launch, bundlers bought in the launch bundles, whales made a single trade of $10,000 or more on the token, insiders received a block of supply without buying it, fresh traders were funded for the first time at most 7 days before their first buy of the token. These labels are given per token.
- Pro traders, smart traders (profitable over the last 30 days) and KOLs (known public traders) are wallet-wide labels;
<label>AllTimeCountcounts the members who traded the token while they carried the label. <label>Countand<label>HoldingsPctfollow current balances;insidersAllTimeCountcounts every wallet that ever received supply that way. A wallet counts in each of its labels, so the shares do not add up. The token’s creator never counts in a label: its holdings aredevHoldingsPct.- Some labels start at a date and stay
nullfor tokens launched before it: whales before June 3, 2026, insiders before October 2, 2026, bundlers before October 29, 2026. Snipers cover the whole history, and fresh traders are tracked token by token. - The all-time counts of pro traders, smart traders and KOLs (
proTradersAllTimeCount,smartTradersAllTimeCount,kolsAllTimeCount) need the token’s full trade history: they are served for tokens launched since October 30, 2026 and for older tokens whose history we have loaded (the actively traded ones),nullotherwise.
lpBurnedPct and lpLockedPct are the shares (0-100) of the liquidity of the token’s main market, named by poolAddress, that are burned and locked. On EVM pools with transferable LP tokens (Uniswap V2 style), a lock past its unlock date no longer counts as locked: its liquidity can be withdrawn at any time. lpSource tells how they are known:measured: read on-chain;declared: the main market belongs to the launchpad the token was launched on (its live bonding curve, the pool its curve migrated to, or a pool it opened), and that launchpad burns or locks its liquidity by design;unknown: both fields arenull.
unknown. For the liquidity of any other pool, use Pool Security.buyTaxBps and sellTaxBps are what a buy or a sell loses beyond the pool’s LP fee: the token’s own tax and any launchpad hook fee, compounded. A token with no tax of its own, traded through a pool whose launch hook takes 1% of each swap, reads 100. transferTaxBps is the tax on a wallet-to-wallet transfer. On Solana, the three fields carry the Token-2022 transfer fee in force (every transfer pays it, buys and sells included; 0 on a mint without a fee), and modifiableTax tells whether that fee can still be changed.isHoneypot is true when a sell loses its whole value, false when a sell was measured below that, null when unknown. Tokens launched from a launchpad or a known token factory are never flagged true. On Solana, isHoneypot is true for a non-transferable mint (it can never be sold), false for a transferable mint with no known block, and null otherwise: the mint has not been read yet, it has an active transfer hook, it is paused, or its accounts are frozen by default. On Solana false means the mint is transferable, not that a sell was simulated. To exclude honeypots on both families, test isHoneypot !== true.renounced is true when the contract owner is an address nobody controls (zero, dead or keyless), false when an owner is set, null when the contract has no readable owner. isProxy is true when the token’s code can be replaced by an administrator (a standard upgradeable proxy) and implementationAddress is the code it runs today (null when it is not a proxy or the implementation is unknown). Read them together: a renounced owner does not stop a proxy administrator from replacing the code. For a full review of a contract, see the contract audit. These three fields are null on Solana.isMintable: the supply can still be increased;transferPausable: transfers or sells can be blocked;isBlacklisted: wallets can be blacklisted;balanceMutable: a privileged role can move or change holders’ balances;modifiableTax: the fees can be changed after deployment;selfDestruct: the contract can destroy itself;upgradeableProxy: the code can be replaced by a key that is not in safe hands (falsefor a proxy whose upgrade key is renounced or held by a known issuer);isNotOpenSource: the source code is not verified.- A capability that the contract has but that is neutralised on-chain (owner renounced, role without members, function locked) reads
false. nullwhen not known; never a fabricatedfalse.isMintable,isBlacklisted,selfDestruct,upgradeableProxyandisNotOpenSourcearenullon Solana: the Solana equivalents aremintRevoked,freezeRevokedand the Token-2022 controls.
isToken2022 (false for a classic SPL mint, whose controls then read false and whose pubkeys read null), transferPausable (the issuer can freeze transfers: accounts born frozen, or the pausable extension) and isPaused (paused right now), balanceMutable with permanentDelegate (an address that can move or burn any holder’s tokens), transferHookProgram (a program run on every transfer), closeAuthority (the authority that can close the mint). null when the mint has not been read yet. These fields are null on EVM.mintRevoked: true means the authority is renounced (safe), false means it is still active, null means unknown. Same for freeze.holdersCount is a dated snapshot, and holdersAsOf gives the day it was taken (YYYY-MM-DD). On every other token, holdersCount is live and holdersAsOf is null.0x0000…0000, 0xeeee…eeee accepted on input) is not a token contract: it has no holder list, no LP, no tax and no mint or freeze authority to screen. It answers 200 with every screening field null, lpSource "unknown" and poolAddress null. A wrapped native coin that is only ever the quote of its markets (WHYPE on HyperEVM) answers the same way, with its holdersCount and holdersAsOf.tokenAddress repeats address and poolAddress is the pool whose liquidity lpBurnedPct, lpLockedPct and lpSource describe (Identity fields). On input, tokenAddress can be sent instead of address.POST /v1/token/security with items[] - up to 100 items per call, across chains.curl 'https://api.serialized.xyz/v1/token/security?chain=solana&address=DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263' \
-H 'Authorization: YOUR_API_KEY'
{
"data": {
"chain": "solana",
"address": "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
"tokenAddress": "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
"poolAddress": "5zpyutJu9ee6jFymDGoK7F6S5Kczqtc9FomP3ueKuyA9",
"holdersCount": 892341,
"holdersAsOf": null,
"top10HoldersPct": 24.83,
"top25HoldersPct": 37.95,
"top50HoldersPct": 48.6,
"top100HoldersPct": 59.12,
"top200HoldersPct": 70.4,
"devHoldingsPct": 0,
"snipersHoldingsPct": 0,
"bundlersHoldingsPct": null,
"snipersCount": 0,
"bundlersCount": null,
"insidersHoldingsPct": null,
"insidersCount": null,
"proTradersCount": 1388,
"proTradersHoldingsPct": 0.107,
"whalesCount": null,
"whalesHoldingsPct": null,
"freshTradersCount": null,
"freshTradersHoldingsPct": null,
"smartTradersCount": 111,
"smartTradersHoldingsPct": 0.032,
"kolsCount": 96,
"kolsHoldingsPct": 0.005,
"snipersAllTimeCount": 1,
"bundlersAllTimeCount": null,
"whalesAllTimeCount": null,
"insidersAllTimeCount": null,
"freshTradersAllTimeCount": null,
"proTradersAllTimeCount": 28606,
"smartTradersAllTimeCount": 627,
"kolsAllTimeCount": 999,
"tokenBurnedPct": null,
"lpBurnedPct": null,
"lpLockedPct": null,
"lpSource": "unknown",
"dexPaid": true,
"dexPaidAt": 1740046431000,
"buyTaxBps": 0,
"sellTaxBps": 0,
"transferTaxBps": 0,
"modifiableTax": false,
"isHoneypot": false,
"mintAuthority": null,
"mintRevoked": true,
"freezeAuthority": null,
"freezeRevoked": true,
"isToken2022": false,
"transferPausable": false,
"isPaused": false,
"balanceMutable": false,
"permanentDelegate": null,
"transferHookProgram": null,
"closeAuthority": null,
"renounced": null,
"isProxy": null,
"implementationAddress": null,
"isMintable": null,
"isBlacklisted": null,
"isNotOpenSource": null,
"selfDestruct": null,
"upgradeableProxy": null
},
"meta": {
"asOf": 1786777912344
}
}
Query Parameters
Response
Standard { data, meta } envelope.