Skip to main content
GET
GET /v1/token · 1 credit Full token snapshot: price (native + USD), market cap, FDV and supplies (total, circulating), liquidity (+ATH), best pool (the token’s main market: the deepest of the pools where it is the priced asset, measured on both sides of the pool, the same market as the first row of /v1/token/pools), launchpad state (bonding progress, graduation), deployer, 24h stats, metadata & socials.
totalSupply is the on-chain supply of the contract on the requested chain. marketCapUsd and fdvUsd are the asset’s circulating market cap and fully diluted value: for an asset issued on several chains (stablecoins, bridged majors) they cover the asset as a whole, across every chain, while totalSupply stays per contract. circulatingSupply is null when the token has no distinct circulating supply; marketCapUsd then equals fdvUsd (totalSupply × price). 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 carries no capitalisation of its own: its totalSupply, circulatingSupply, marketCapUsd and fdvUsd are null; the coin’s own figures live on the native coin entry. Its liquidity and stats24h are the wrapper contract’s markets.
The native coin entry (0x0000000000000000000000000000000000000000 on every EVM chain, 0xeeee…eeee accepted as an alias on input; the SOL mint on Solana) carries the coin’s own marketCapUsd, fdvUsd and circulatingSupply, with priceNative "1" and priceUsd equal to /v1/prices/native. The native coin has no market of its own: it is the quote of its chain’s markets, so on EVM pool is null and liquidityUsd and stats24h are the activity of its wrapped markets (WETH, WBNB…). Its markets are listed by /v1/token/pools.
pool is the token’s main market: the deepest of the pools where the token is the priced asset, measured on both sides of the pool (a pool that is deep on one side only never wins), launchpad curves and trusted factories first. It is the first row of /v1/token/pools, and the pool the default candles, sparklines and /v1/token/price follow. null for the EVM native coin, which has no market of its own.
priceNative, priceUsd, marketCapUsd, fdvUsd, liquidityNative, liquidityUsd, priceNativeAth 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".
createdAt is the TRUE deploy time (launchpad pool) - launchpad.graduatedAt carries the graduation: the migration to the AMM pool, or the moment the curve completed for launchpads that graduate in place and keep trading on the same market (Noxa.Fun).
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. 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). 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).
deployer is the token’s creator wallet: the launchpad creator when the token has a launchpad lineage, otherwise the wallet that created its canonical pool - never the migration transaction sender. 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, pool for the creator of the canonical pool) and 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; txns is the number of distinct transactions in the window. priceChangePct is the price change over the 24h window, in percent. null when the window carries no priced trades.
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.

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
required

Token address (EVM hex, case-insensitive).

Response

200

Standard { data, meta } envelope.