Glossary - Chronos API

Definitions for the wallet classifications, holder groups, launchpad terms and market terms used across the API.

Wallet classifications

A trade’s flags, the flags query parameter and the spot.trades flags filter use these values. A wallet can carry several. The exact rules can differ slightly between chains.

Value	Meaning
`dev`	The wallet that created the token.
`sniper`	Bought the token within two blocks of its first pool.
`insider`	Bought the token within three blocks of its first pool. Every sniper is also an insider.
`bundler`	Made the fourth or later buy of the token in a single block.
`fresh`	Was funded less than seven days before it traded. The flag drops once that is no longer true.
`whale`	Made a single trade worth $10,000 or more.
`kol`	Labelled a key opinion leader by a wallet-label source.
`pro_trader`	Has traded through a known trading terminal.
`fomo`	Has traded through the fomo.family terminal. As a filter, `fomo` instead keeps trades routed through that terminal; see Filtering and sorting.
`phishing`	Named by a security source as a malicious actor: phishing, scamming, rug pulling or hacking.

New classifications appear over time. Keep values you do not recognize.

Holder groups

A token’s holders object measures how much supply each group holds now, on a 0–100 scale, and how many wallets have ever belonged to the group on that token.

Field	Group
`top10Pct`	The 10 largest current holders. Can read above 100 when supply data drifts.
`devPct`	The creator
`sniperPct`, `sniperCount`	Wallets flagged `sniper`
`bundlerPct`, `bundlerCount`	Wallets flagged `bundler`
`insiderPct`, `insiderCount`	Wallets flagged `insider`
`freshWalletPct`, `freshWalletCount`	Wallets flagged `fresh`
`proTraderPct`, `proTraderCount`	Wallets flagged `pro_trader`
`fomoPct`, `fomoCount`	Wallets flagged `fomo`
`phishingPct`, `phishingCount`	Wallets flagged `phishing`
`fundedByCexPct`	Share of current holders, not of supply, that a known exchange funded

Each Count field counts every wallet that ever carried the flag on the token, so it never decreases. Pools, lockers and system accounts are not counted as holders.

Launchpad terms

Term	Meaning
Launchpad	A venue that launches new tokens and sells them from a bonding curve, such as Pump.fun. A token’s `launchpad` names it.
Bonding curve	The launchpad’s pricing contract. The price rises as the curve fills.
`bondingCurvePct`	How full the curve is, 0–100.
Graduation	The moment a token leaves its launchpad and its liquidity moves to a regular pool. `graduatedAt` records it, and `graduatedToPool` and `graduatedToDex` say where it went.
New pairs	Launchpad tokens below 40% of their curve.
Graduating	Launchpad tokens at 40% of their curve or more, not yet graduated.
Graduated	Launchpad tokens that have graduated, or that have no curve reading.

Market terms

Term	Meaning
Native unit	The chain’s gas asset: SOL on Solana, ETH on Base and Robinhood Chain, BNB on BNB Smart Chain.
Anchor (quote asset)	The asset a token’s deepest pool prices it against, such as WSOL or USDC: `anchorSymbol` and `anchorAddress`.
Market cap	Price times total supply.
Liquidity	The value held in the token’s pools.
Money object	A `{native, usd}` pair. See Reading responses.