Skip to main content
GET
GET /v1/token · 2 credits (windows included; 4 with include=security)
Live: the token-updates stream channel pushes the mutable fields of this snapshot (price, market cap, liquidity, bonding progress, stats24h) as they change.
Full token snapshot: price (native + USD), market cap, FDV and supplies (total, circulating), liquidity across the token’s most traded markets (+ATH), its main market (pool, with its own liquidity: the first row of /v1/token/pools and the market its price follows), launchpad state (bonding progress, graduation), deployer and its launch record, holders and top 10, labels and taxes, 24h stats, metadata & socials.
marketCapUsd = circulatingSupply × priceUsd and fdvUsd = totalSupply × priceUsd on every token. For majors, stablecoins and native coins, and for the largest tokens by market cap (about the first 2,000 assets), circulatingSupply and totalSupply are the asset’s, across every chain it is issued on: locked, vesting and treasury tokens do not count as circulating, and a bridged copy carries the market cap of its asset. For every other token, totalSupply is the on-chain supply of the contract and circulatingSupply is that supply minus the tokens held by burn addresses (0x000000000000000000000000000000000000dEaD and the zero address on EVM chains; 1nc1nerator11111111111111111111111111111111, 11111111111111111111111111111111 and dead111111111111111111111111111111111111111 on Solana); when the burned amount of a token is not known yet, circulatingSupply and marketCapUsd are null and fdvUsd is still served. /v1/token/price, /v1/search, /v1/screener, /v1/pulse, /v1/pool/data, /v1/wallet/positions and the streams serve the same marketCapUsd. Wrapped natives (WETH, WBNB, WgUSDT…) and the chain’s native coin (0x000...000 on EVM, the SOL mint on Solana) are priced at priceNative "1" by construction, priceUsd being the same spot as /v1/prices/native. A wrapped native is capitalised on what it holds: its totalSupply and circulatingSupply are the wrapper contract’s on-chain supply, marketCapUsd = fdvUsd = that supply × priceUsd (the coin’s own figures live on the native coin entry). Its liquidity and stats24h are the wrapper contract’s markets.
chainTotalSupply and chainMarketCapUsd are the figures of the contract on this chain, whatever the asset it belongs to: chainTotalSupply is the on-chain supply of the contract (a decimal string, like totalSupply) and chainMarketCapUsd = chainTotalSupply × priceUsd. For a major, a stablecoin or a large token issued on several chains they are the supply bridged or minted on this chain (USDT on BNB Smart Chain: about 9 G against the asset’s 180 G in totalSupply; AAVE on Base: about 36 k against the asset’s 16 M); for every other token and for a wrapped native they equal totalSupply and fdvUsd; for the native coin entry they are null (a coin has no contract). Both are null while the on-chain supply is not known.
The native coin entry (0x0000000000000000000000000000000000000000 on every EVM chain, 0xeeee…eeee accepted as an alias on input; the SOL mint on Solana, where 0x0000…0000 and 0xeeee…eeee are accepted too) carries the coin’s own marketCapUsd, fdvUsd and circulatingSupply, with priceNative "1" and priceUsd equal to /v1/prices/native. liquidityUsd and stats24h cover its markets, wrapped form included (WETH, WBNB…), and pool is its main USD market. Its markets are listed by /v1/token/pools.
pool is the token’s main market: its launch curve while it trades there, then the market it graduated to, otherwise the market where the token trades best (real depth close to its price, real trading, a quote asset we trust), by one rule on every chain. It is the first row of /v1/token/pools, and the market the price, the price change, the default candles, the sparklines and /v1/token/price follow. For a native coin and its wrapped form it is the coin’s main USD market; null for the native coin of Tempo, Arc and Stable, whose native is itself a USD stablecoin, and for a token that has no market of its own (a token only ever traded as the quote of other tokens’ markets). pool.liquidityNative and pool.liquidityUsd are that market’s own liquidity (null on majors, stablecoins, wrapped natives and native coins, whose figures cover all their markets; a market’s own figures are on /v1/pool/data). pool.quoteName and pool.quoteIconUrl are the name and logo of the pool’s quote token, null when unknown.
pool.pooledBase and pool.pooledQuote are what sits in the main market: the amount of its base token (the token itself, or the stablecoin of a native coin’s USD market) and of its quote token, in token units (decimal-adjusted). pool.pooledBaseNative values the base side at the market’s own price, pool.pooledQuoteNative the quote side as the market’s liquidity counts it: on a market whose quote token has little real market of its own, the quote side is capped like pool.liquidityNative. A side worth nothing reads "0"; a side that cannot be priced is null. All four are null on a launch curve (its reserves follow the launchpad’s own accounting, not what is in the pool), when the indexed reserves of a concentrated-liquidity market are not reliable (a negative running total), before the market ever held anything, and on majors, stablecoins, wrapped natives and native coins like pool.liquidityNative. The same four fields, with the same values, are on each row of /v1/token/pools, on /v1/pool and on /v1/pool/data.
tokenAddress repeats address, and poolAddress names the main market (pool.address, null when pool is): see Identity fields. On input, tokenAddress can be sent instead of address.
liquidityNative and liquidityUsd are the token’s liquidity: its most traded markets summed, each counted on its smaller side, the depth a trade can actually use. A launch curve still trading counts with the liquidity its launchpad shows; order books and proprietary AMMs hold a market maker’s inventory, not pooled liquidity, and are not counted. Majors, stablecoins, wrapped natives and native coins carry the liquidity of all their markets. It is the same figure as /v1/token/price, the Screener and Pulse token rows and the token-updates stream. liquidityNativeAth is the highest liquidity recorded on the main market.
priceNativeAth is the token’s all-time-high price in the native coin: the highest price recorded on its main market or on the launch curve it graduated from, kept only when that market held enough liquidity to back it (a high its liquidity could never support is a broken price, left out), and never below the current price. marketCapAthUsd = priceUsdAth × circulatingSupply, so it is never below marketCapUsd. Both are null when no credible high is on record, and on majors, stablecoins and native coins.
priceUsdAth is the token’s all-time-high price in USD. On Solana, each trade is valued at the native coin’s USD price of its own moment, and priceUsdAthAt dates that high; it is never below priceUsd. On EVM chains, and on Solana when that USD high is not on record, priceUsdAth is priceNativeAth × the native coin’s current USD price, and priceUsdAthAt is null. priceUsdAth is null exactly when priceNativeAth is. On Solana, priceNativeAthAt is when the native high was reached (ms epoch); the two dates can differ. While the current price is the high, its date is the latest trade on the main market. The two dates are null when not on record, and on EVM chains. The list rows (Pulse, Screener, search, streams) carry the same priceUsdAth and marketCapAthUsd.
priceNative, priceUsd, marketCapUsd, fdvUsd, liquidityNative, liquidityUsd, priceNativeAth, priceNativeAthAt, priceUsdAth, priceUsdAthAt, marketCapAthUsd and liquidityNativeAth are null when the token has not traded yet; stats24h then reports measured zeros. A token whose price fell to zero after trading keeps priceNative "0".
feesPaidNative and feesPaidUsd are the fees paid by traders on the main market (pool) since its creation: network fees, plus validator tips and trading-terminal fees on Solana. For a token that graduated from a launchpad, the fees paid on its bonding curve are counted once. feesPaidNative is a decimal string in the chain’s native unit; feesPaidUsd converts it at the current native price, like liquidityUsd. Both are null when not known. They are a lifetime figure of the main market alone; the fees paid over a window, summed over all the token’s pools, are feesNative / feesUsd in stats24h and in each windows block.
createdAt is when the token’s first trading pool opened: the first market where the token trades, launchpad curve included, the same value as /v1/search. It is null on a native coin, which has no trading pool of its own. pool.createdAt is when the main market opened. tokenCreatedAt (the same value as createdAt) and poolCreatedAt (the same value as pool.createdAt, null when pool is) carry these two dates under the names the Screener, Pulse and search rows use. lastTradeAt is the time of the token’s latest trade on its markets (its deepest markets, its launch curve and the market it graduated to), in ms; null when none is recorded, and on majors, stablecoins and native coins. launchpad.graduatedAt carries the graduation: the migration to the AMM pool, the moment the curve completed for launchpads that graduate in place and keep trading on the same market (Noxa.Fun), or the moment the token reached the goal of a launchpad that launches straight into its pool (Clanker, Bankr, Zora…). It is null before the graduation, and when the graduation is not dated.
launchpad is served for every token that comes from a launchpad and is null for any other token. launchpad.bondingProgress reaches 100 at graduation and stays 100 once graduated (launchpad.migrated: true, whether the liquidity moved to a new pool or the curve completed in place); the market endpoint reports the same value for the curve. Launchpads with no bonding curve (Clanker, Bankr, Zora…; synthetic in the bonding field of GET /v1/meta/factories) launch straight into their pool and are served the same way: bondingProgress is the progress toward the launchpad’s liquidity or market cap goal, the value Pulse ranks on, and migrated is true once that goal is reached; /v1/pool and /v1/pool/data report the same bondingProgress and migrated on that pool. A market cap goal is set in USD: on those launchpads the progress, and migrated with it, are measured at the current price of the native coin. launchpad.launchpadPoolAddress is the original bonding-curve market when it is addressable on /v1/pool; null for launch mechanisms without a dedicated curve market (Uniswap CCA auctions, and the launchpads that launch straight into their pool, whose market is pool). metadata.iconUrl is the token’s icon on our image CDN (serialized.cloud): a stable WebP URL, safe to cache indefinitely; metadata.headerUrl is always a fetchable https URL (IPFS and Arweave pointers resolved to a public gateway). Native coins, wrapped natives (WETH, WBNB…) and the main quote stablecoins of each chain (USDC, USDT, DAI…) carry the metadata of their asset: its logo (served from cdn.serialized.xyz) and its official website, X and Telegram links, with headerUrl, discordUrl, description, dexPaid and dexPaidAt null.
deployer is the token’s creator wallet: the launchpad creator when the token has a launchpad lineage; otherwise the wallet that ran the token’s first mint; otherwise, on EVM, the wallet that created the token’s first market. Never the migration transaction sender. Native coins, wrapped natives, USD stablecoins and the majors (WETH, USDC, WBTC…) have no creator on EVM: deployer is null, their first market having been opened by a liquidity provider. EVM addresses are lowercase. deployerSource says which arm resolved it (metadata when the launchpad’s metadata feed names the creator, launchpad for the creator of the original bonding curve, mint for the wallet of the first mint, pool for the creator of the token’s first market) and is null whenever deployer is null. Pulse and Screener rows name the same wallet in creator.address.
deployTxHash is the hash of the transaction that created the token, for a token born on a launchpad bonding curve: the launchpad creates the token and its curve in one transaction (pump.fun, Meteora DBC, LaunchLab and the other Solana launchpads; Four.meme, Flap and the other EVM curve launchpads). It is null for any other token: a token first listed on a DEX, a launchpad without a bonding curve (Clanker, Zora, Bankr…), the majors, stablecoins and native coins. Never the hash of a token’s first DEX pool.
creator is the launch record of that wallet: address (the same wallet as deployer), launchedCount (on EVM, every token this wallet created, on a launchpad or not, every EVM chain together; on Solana, the tokens it launched on a launchpad) and migratedCount (how many of them graduated: on EVM, a curve that migrated to a DEX pool, a curve that completed in place, or a launchpad threshold crossed on the token’s pool; on Solana, a launchpad curve that migrated to a DEX pool). Both counts are null when unknown, never 0, and are the values of creator on Pulse and Screener rows. creator is null whenever deployer is null.
stats24h is the token-wide 24h window, the same window as the 24h block of /v1/token/stats. buys/sells and buyVolumeNative/sellVolumeNative split flow by direction, and buyVolumeUsd/sellVolumeUsd give the two sides in USD, at the same rate as volumeUsd; txns is the number of distinct transactions in the window. uniqueBuyers/uniqueSellers are the unique wallets that bought / sold in the window. traders is the number of unique wallets that bought or sold in the window, each wallet counted once across the token’s pools (null on majors, stablecoins, wrapped natives and native coins). feesNative and feesUsd are the fees paid by traders in the window (network fees on EVM chains; network fees, validator tips and trading-terminal fees on Solana), summed over the token’s pools (a transaction routed through two of them counts in each): feesNative in the chain’s native unit, feesUsd at the same rate as volumeUsd (both null on majors, stablecoins, wrapped natives and native coins). priceChangePct is the price change of the token’s main market over the 24h window (its launch curve included before graduation), in percent, the same market as priceUsd and the candles; on a native coin and its wrapped form (WETH, WBNB…) it is the coin’s USD price change. null when the window carries no priced trades.
windows adds the sliding windows of /v1/token/stats to the snapshot: pass any of 1m, 5m, 15m, 30m, 1h, 4h, 6h, 12h, 24h (comma-separated, or with the parameter repeated) and the token ends with a windows object, one block per window from the shortest to the longest (the order of the token-updates stream), with the fields of stats24h and the same figures as /v1/token/stats token-wide. The 24h block is stats24h itself. A window is null when it is unknown, never a made-up 0. Without windows, or with an empty value, the response does not change. The windows are included in the price of the call, 2 credits with or without them. The 1m window covers the last 60 seconds: it is null when it is not known yet; on majors, stablecoins and wrapped natives it carries the price change only, when there is one (null on wrapped natives and on USD stablecoins of EVM chains); on a native coin it is null.
Holders, labels and taxes, with the names, definitions and figures of /v1/token/security: holdersCount, top10HoldersPct (the 10 largest holders’ share of the supply: 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) and devHoldingsPct (the share held by deployer). For the stablecoins and wrapped native coins of EVM chains (USDC, USDT, WETH, WBNB, WHYPE and the like), holdersCount is a dated snapshot rather than a live count; /v1/token/security gives its date in holdersAsOf. On Solana, snipersHoldingsPct, bundlersHoldingsPct and insidersHoldingsPct are the share of the supply those wallets hold now, each followed by the number of those wallets still holding the token (snipersCount, bundlersCount, insidersCount; the token’s creator never counts), and proTradersAllTimeCount is the number of pro traders who ever traded the token, sold or not; each is null when it is not known for the token (bundlers on tokens launched before October 29, 2026, insiders before October 2, 2026, pro traders on older tokens whose trade history is not loaded, and the stablecoins and quote tokens kept out of wallet labels), a share and its count are known together, and all seven are null on EVM chains, where the sniper and bundler figures are on /v1/token/security. risk is the block of the Screener and Pulse rows: buyTaxBps, sellTaxBps, transferTaxBps, isHoneypot, transferPausable, balanceMutable, modifiableTax, on Solana mintRevoked, freezeRevoked, and on EVM chains the contract flags isMintable, isBlacklisted, isNotOpenSource, selfDestruct, upgradeableProxy. A value not known yet when the token is served (a token no list or page asked for in the last minute) is null in that answer and is filled within seconds for the next call; LP locks and the full set of contract flags come in the same call with include=security (next note); the full security sheet (top 25 to 200, every label held and traded) is /v1/token/security.
include=security adds a tokenSecurity object to the token, right after risk (and before windows): the liquidity safety of the token’s main market and every contract flag, in the same call. poolAddress names the pool whose liquidity is read, lpBurnedPct and lpLockedPct are the shares of that liquidity that are burned and locked (0-100) and lpSource tells how they are known (declared, measured or unknown). The flags are modifiableTax, transferPausable and balanceMutable on every chain; mintAuthority, mintRevoked, freezeAuthority, freezeRevoked, isToken2022, isPaused, permanentDelegate, transferHookProgram and closeAuthority on Solana; renounced, isProxy, implementationAddress, isMintable, isBlacklisted, isNotOpenSource, selfDestruct and upgradeableProxy on EVM chains. Each field has the name, the definition and the value it has on /v1/token/security for the same token, in the same order; a field is null when it is unknown or does not apply to the chain family, never a made-up false. top100HoldersPct and top200HoldersPct, right after poolAddress, are the shares of the supply held by the 100 and 200 largest holders, with the rule and the values of /v1/token/security (the same exclusions as top10HoldersPct: pools, custody, burn addresses). They come from a deeper read than the rest of the block: when it does not finish within the same wait, both are null in that response and the rest of the block is served; the same call a few seconds later usually returns them. The block does not repeat what the token already carries: taxes and isHoneypot are in risk, dexPaid in metadata, holders, the top 10, 25 and 50 and the labels at the root. On EVM chains risk.transferPausable, risk.balanceMutable and risk.modifiableTax are null: read these three in tokenSecurity. The eight labels with their all-time counts and the pro traders holding the token stay on /v1/token/security; the liquidity safety of another pool is on /v1/pool/security.
include=security costs 2 more credits: the call is billed 4 credits when the block is served. tokenSecurity is null when the token’s security sheet is not available; the option is then not billed (the call costs 2 credits). Every call with include=security counts in the Security rate group, the one of /v1/token/security and /v1/pool/security (100 per minute per key by default, raised on request), whether the block is served or not. Past the cap the whole call answers 429 with details.group security; the same call without include still passes. An unknown value of include is a 400. Without include, or with an empty value, the response does not change. include=security is not available on the keyless playground of this documentation.
pool.factoryAddress is the on-chain address that created the main market: the pair factory on EVM chains (the PoolManager on Uniswap V4 and its forks, where the launchpad is the pool’s hook), the program of the market’s venue on Solana (pAMMBay6oceH9fJKBRHGP5D4bD4sWpmSwMn52FMfXEA for PumpSwap). launchpad.factoryAddress is the same for the launch curve (6EF8rrecthR5Dkzon8Nwu78hRvfCKubJ14M5uBEwF6P for pump.fun). pool.factory keeps naming the launchpad. On pump.fun tokens, launchpad.isMayhemMode says the coin was created in Mayhem Mode and launchpad.isCashbackCoin that it is a cashback coin (pump.fun stopped creating them in September 2026); both are null on any other launchpad and on EVM chains. Both addresses are null when unknown, and on majors, stablecoins and native coins; launchpad.factoryAddress is also null for a launchpad without a launch curve of its own, like launchpad.launchpadPoolAddress.
metadata.links lists the token’s other links, beyond websiteUrl, twitterUrl, telegramUrl and discordUrl: each one has a type (the network: tiktok, instagram, reddit, github, youtube…; null for a named page), a label (as the token’s profile names it: “Docs”, “Whitepaper”…; null when none) and an https url; [] when the profile has none, null when no profile is known. metadata.uri is the token’s metadata URI as set at its creation, verbatim (on Solana its Metaplex URI; on EVM chains the URI a launchpad records, sometimes a bare IPFS CID), null when the token has none. metadata.dexscreenerBoosted is true once the token has been boosted on DEX Screener, false when it never was, null when unknown.
metadata.coingeckoUrl is the token’s page on CoinGecko, null when it has none. metadata.listed says whether CoinGecko lists the token: true when it does, false when it does not, null when unknown (a chain CoinGecko does not cover, a native coin without a CoinGecko page, or a listing that could not be read). A link always comes with listed: true, and listed is about this token’s contract on this chain. Majors, stablecoins and native coins link to the page of their asset (USDT on BNB Chain links to Tether). The listing is refreshed daily: a token CoinGecko has just listed reads false until the next refresh.
metadata.dexPaid is true, false, or null (status unknown) - never a fabricated false. When our index has no record for a token, the status is resolved from DEX Screener’s listing records. metadata.dexPaidAt is the payment time in ms, or null.
The other DEX Screener products: metadata.dexAdPaid is true once an ad was paid for the token on DEX Screener (a token ad or a trending-bar ad), false when its payment records show none, null when unknown, and metadata.dexAdPaidAt is the time of its first ad payment, in ms. metadata.dexscreenerBoostedAt is the time of its first boost, in ms (null when it was never boosted, or when its boost history is not fully known). metadata.dexscreenerBoostActive is true while a boost is running, false when none is, null when unknown. metadata.dexscreenerListed is true when the token has a page on DEX Screener, false when it has none, null when unknown. The five are null on majors, stablecoins and native coins, and come in this order at the end of metadata.

Authorizations

Authorization
string
header
required

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

Query Parameters

chain
string
required

Public chain id - evm:<id> or solana (solana:solana accepted).

address
string

Token address (EVM hex, case-insensitive). Or send it as tokenAddress.

tokenAddress
string

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

windows

Stat windows among 1m, 5m, 15m, 30m, 1h, 4h, 6h, 12h, 24h, comma-separated or with the parameter repeated. Adds a windows object at the end of the token, one block per window you ask, with the fields of stats24h: the same blocks as /v1/token/stats for this token. Absent unless you ask; an empty value adds nothing. The windows are included in the price of the call. The 1m window covers the last 60 seconds; it is null when it is not known yet. On majors, stablecoins and wrapped natives it carries the price change only, when there is one (null on wrapped natives and on USD stablecoins of EVM chains); on a native coin it is null.

include

Extras, comma-separated or with the parameter repeated. security adds a tokenSecurity object right after risk: the liquidity safety of the token's main market (poolAddress, lpBurnedPct, lpLockedPct, lpSource), the shares of its 100 and 200 largest holders (top100HoldersPct, top200HoldersPct) and every contract flag, with the names and values of /v1/token/security. 2 more credits when the block is served (4 for the call). Absent unless you ask; an empty value adds nothing; an unknown value is a 400.

Response

200

Standard { data, meta } envelope.