Skip to main content
GET
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 (with holdersAsOf, the day of the figure when it is a snapshot: stablecoins and wrapped native coins on EVM chains, null when the count is live), and the shares of supply held by the largest holders: top10HoldersPct, top25HoldersPct, top50HoldersPct, top100HoldersPct and top200HoldersPct (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 EVM null when it cannot be measured exactly, never a partial sum; on Solana see the concentration note below), devHoldingsPct.
  • Launch quality - snipersCount / snipersHoldingsPct and bundlersCount / 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 / insidersHoldingsPct and proTradersCount / 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), for snipers, bundlers, whales, insiders, freshTraders, proTraders, smartTraders and kols.
  • 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 flags isMintable, 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.
The liquidity safety and the contract flags of this sheet also come with the token details: 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.
Concentration, on EVM and Solana: 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.
Launch quality, on EVM and Solana:
  • Snipers are wallets that bought in the first blocks (Solana: slots) after launch. snipersCount is the number of them still holding the token, snipersHoldingsPct the 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). bundlersCount is the number of them still holding the token, bundlersHoldingsPct the 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. 0 means none detected; null means the figure cannot be measured exactly for this token.
Holder profile, on EVM and Solana:
  • Insiders are wallets linked to the token’s team or creator. insidersCount is the number of insiders holding the token (on EVM, among its main holders), insidersHoldingsPct the 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 proTrader wallet label). proTradersCount is the number of them currently holding the token, proTradersHoldingsPct the share of supply they hold (0-100), from their current balances (on EVM, with the exclusions of top10HoldersPct: liquidity pools, burn wallets, CEX custody and launchpad lockers set aside).
  • A wallet can be both an insider and a pro trader. 0 means none detected; null means the figure cannot be measured exactly for this token.
Wallet labels, on Solana (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>AllTimeCount counts the members who traded the token while they carried the label.
  • <label>Count and <label>HoldingsPct follow current balances; insidersAllTimeCount counts 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 are devHoldingsPct.
  • Some labels start at a date and stay null for 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), null otherwise.
Liquidity safety, on EVM and Solana: 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 are null.
When the main market of a launchpad token is a pool a trader opened on a DEX, it carries its own on-chain reading, or unknown. For the liquidity of any other pool, use Pool Security.
Taxes, in basis points (100 = 1%): on EVM, 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.
Honeypot: on EVM, 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.
Contract control, on EVM: 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.
Contract flags, on EVM:
  • 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 (false for 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.
  • null when not known; never a fabricated false. isMintable, isBlacklisted, selfDestruct, upgradeableProxy and isNotOpenSource are null on Solana: the Solana equivalents are mintRevoked, freezeRevoked and the Token-2022 controls.
Token-2022 controls, on Solana: 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.
Authority tri-state: mintRevoked: true means the authority is renounced (safe), false means it is still active, null means unknown. Same for freeze.
Holders count of the stablecoins and wrapped native coins on EVM chains (USDC, USDT, WETH, WBNB, WHYPE and the like): 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.
The EVM native coin (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.
Available as a batch: POST /v1/token/security with items[] - up to 100 items per call, across chains.

Authorizations

Authorization
string
header
required

Your raw API key (not needed on the demo server).

Query Parameters

chain
string
required

Public chain id (solana: LP burn and lock analysis is served on Solana).

address
string

Token mint (base58, case-sensitive). Or send it as tokenAddress.

tokenAddress
string

The explicit name of address (the token): send one of the two.

Response

200

Standard { data, meta } envelope.