curl 'https://api.serialized.xyz/v1/search?q=degen' -H 'Authorization: YOUR_API_KEY'
curl 'https://api.serialized.xyz/v1/search?q=pepe&chain=evm:1,evm:56,solana&sortBy=volume&liquidityMin=10000' -H 'Authorization: YOUR_API_KEY'
curl 'https://api.serialized.xyz/v1/search?q=pepe&chain=solana&sortBy=volume1h' -H 'Authorization: YOUR_API_KEY'
curl 'https://api.serialized.xyz/v1/search?q=eth&chain=evm:1,evm:8453' -H 'Authorization: YOUR_API_KEY'
curl -G 'https://api.serialized.xyz/v1/search' -H 'Authorization: YOUR_API_KEY' \
--data-urlencode 'q=pepe' --data-urlencode 'chain=evm:8453,solana' \
--data-urlencode 'filters={"risk.sellTaxBps":{"lte":500},"holdersCount":{"gte":500},"NOT":{"symbol":{"contains":"inu"}}}'
curl 'https://api.serialized.xyz/v1/search?q=dog&chain=solana&sortBy=holders&timeframe=1h&volumeMin=1000' -H 'Authorization: YOUR_API_KEY'
curl 'https://api.serialized.xyz/v1/search?q=intel&chain=solana&excludeCategories=stock,staked' -H 'Authorization: YOUR_API_KEY'
{
"data": [
{
"chain": "evm:8453",
"address": "0x4ed4e862860bed51a9570b96d89af5e1b0efefed",
"tokenAddress": "0x4ed4e862860bed51a9570b96d89af5e1b0efefed",
"poolAddress": "0x0ca6485b7e9cf814a3fd09d81672b07323535b64",
"name": "Degen",
"symbol": "DEGEN",
"decimals": 18,
"nameRank": 2,
"priceUsd": 0.0010305242898887457,
"liquidityUsd": 239687.07091684965,
"marketCapUsd": 37436168.14123417,
"volume24hUsd": 57125.74099077385,
"volume1hUsd": 1494.3552616863567,
"organicVolume24hUsd": null,
"priceChange1hPct": -0.10397104623411314,
"priceChange24hPct": 3.747121113042337,
"pool": {
"address": "0x0ca6485b7e9cf814a3fd09d81672b07323535b64",
"type": "UNISWAP_V3",
"factory": null,
"factoryAddress": "0x33128a8fc17869897dce68ed026d694621f6fdfd",
"launchpad": null,
"exchange": {
"name": "Uniswap V3",
"logo": "https://serialized.cloud/logos/dex/uniswap.680e6da3.svg"
}
},
"iconUrl": "https://serialized.cloud/token/6a2c16da-8530-4186-b2a8-9b54cc2d04cf/icon",
"socials": {
"website": "https://www.degen.tips",
"twitter": "https://x.com/degentokenbase",
"telegram": null,
"discord": null,
"links": null,
"uri": null
},
"listed": true,
"createdAt": 1705088299000,
"tokenCreatedAt": 1705088299000,
"poolCreatedAt": 1705088299000,
"lastTradeAt": 1794931157000,
"graduatedAt": null,
"launchpadPoolAddress": null,
"launchpadFactoryAddress": null,
"holdersCount": 1193360,
"bondingProgress": 0,
"migrated": false,
"creator": {
"address": "0xac937655e7b69934eaf0ef56a7f38ece1d74b451",
"launchedCount": null,
"migratedCount": null
},
"stats": {
"1h": { "volumeUsd": 1494.3552616863567, "feesUsd": 0.41, "buys": 9, "sells": 6, "txns": 15, "priceChangePct": -0.10397104623411314 },
"24h": { "volumeUsd": 57125.74099077385, "feesUsd": 14.87, "buys": 312, "sells": 251, "txns": 563, "priceChangePct": 3.747121113042337 }
},
"top10HoldersPct": 31.62,
"top25HoldersPct": 44.08,
"devHoldingsPct": null,
"top50HoldersPct": null,
"snipersHoldingsPct": null,
"bundlersHoldingsPct": null,
"insidersHoldingsPct": null,
"proTradersAllTimeCount": null,
"risk": {
"buyTaxBps": 0,
"sellTaxBps": 0,
"transferTaxBps": 0,
"isHoneypot": false,
"mintRevoked": null,
"freezeRevoked": null,
"transferPausable": false,
"balanceMutable": false,
"modifiableTax": false,
"isMintable": false,
"isBlacklisted": false,
"isNotOpenSource": false,
"selfDestruct": false,
"upgradeableProxy": false
},
"priceNativeAth": "0.0000182",
"priceUsdAth": 0.006747184078,
"marketCapAthUsd": 245107000.5,
"category": null
},
{
"chain": "evm:1",
"address": "0xbe92b510007bd3ec0adb3d1fca338dd631e98de7",
"tokenAddress": "0xbe92b510007bd3ec0adb3d1fca338dd631e98de7",
"poolAddress": "0xe0fe0440a7121a8815a49de4f15508123c4102e7",
"name": "Degen",
"symbol": "DEGEN",
"decimals": 18,
"nameRank": 63,
"priceUsd": 0.0000010794758137739666,
"liquidityUsd": 128072.76371509997,
"marketCapUsd": 161390.44514953013,
"volume24hUsd": 0,
"volume1hUsd": 0,
"organicVolume24hUsd": null,
"priceChange1hPct": null,
"priceChange24hPct": null,
"pool": {
"address": "0xe0fe0440a7121a8815a49de4f15508123c4102e7",
"type": "UNISWAP_V2",
"factory": null,
"factoryAddress": "0x5c69bee701ef814a2b6a3edd4b1652cb9cc5aa6f",
"launchpad": null,
"exchange": {
"name": "Uniswap V2",
"logo": "https://serialized.cloud/logos/dex/uniswap.680e6da3.svg"
}
},
"iconUrl": null,
"socials": {
"website": null,
"twitter": null,
"telegram": null,
"discord": null,
"links": null,
"uri": null
},
"listed": null,
"createdAt": 1683837491000,
"tokenCreatedAt": 1683837491000,
"poolCreatedAt": 1683837491000,
"lastTradeAt": 1794741959000,
"graduatedAt": null,
"launchpadPoolAddress": null,
"launchpadFactoryAddress": null,
"holdersCount": null,
"bondingProgress": 0,
"migrated": false,
"creator": null,
"stats": {
"1h": { "volumeUsd": 0, "feesUsd": 0, "buys": 0, "sells": 0, "txns": 0, "priceChangePct": null },
"24h": { "volumeUsd": 0, "feesUsd": 0, "buys": 0, "sells": 0, "txns": 0, "priceChangePct": null }
},
"top10HoldersPct": null,
"top25HoldersPct": null,
"devHoldingsPct": null,
"top50HoldersPct": null,
"snipersHoldingsPct": null,
"bundlersHoldingsPct": null,
"insidersHoldingsPct": null,
"proTradersAllTimeCount": null,
"risk": {
"buyTaxBps": null,
"sellTaxBps": null,
"transferTaxBps": null,
"isHoneypot": null,
"mintRevoked": null,
"freezeRevoked": null,
"transferPausable": false,
"balanceMutable": false,
"modifiableTax": false,
"isMintable": false,
"isBlacklisted": false,
"isNotOpenSource": false,
"selfDestruct": false,
"upgradeableProxy": false
},
"priceNativeAth": null,
"priceUsdAth": null,
"marketCapAthUsd": null,
"category": null
}
],
"meta": {
"asOf": 1786725099432,
"complete": true,
"hasMore": false
}
}
Token Search
Token search by address, name or ticker, across any number of chains in one call. Results are ranked by relevance: the most significant token behind the text comes first. Native coins (ETH, SOL, BNB…) are part of the results. Sort by liquidity, market cap, volume, holders, all-time high or any figure of the row, and filter with the Screener’s filters. Results carry the token’s price, liquidity, market cap, 1h and 24h figures (volume, fees, buys, sells, transactions, price change), socials, holders, bonding progress, creator, taxes and token flags, and all-time high.
curl 'https://api.serialized.xyz/v1/search?q=degen' -H 'Authorization: YOUR_API_KEY'
curl 'https://api.serialized.xyz/v1/search?q=pepe&chain=evm:1,evm:56,solana&sortBy=volume&liquidityMin=10000' -H 'Authorization: YOUR_API_KEY'
curl 'https://api.serialized.xyz/v1/search?q=pepe&chain=solana&sortBy=volume1h' -H 'Authorization: YOUR_API_KEY'
curl 'https://api.serialized.xyz/v1/search?q=eth&chain=evm:1,evm:8453' -H 'Authorization: YOUR_API_KEY'
curl -G 'https://api.serialized.xyz/v1/search' -H 'Authorization: YOUR_API_KEY' \
--data-urlencode 'q=pepe' --data-urlencode 'chain=evm:8453,solana' \
--data-urlencode 'filters={"risk.sellTaxBps":{"lte":500},"holdersCount":{"gte":500},"NOT":{"symbol":{"contains":"inu"}}}'
curl 'https://api.serialized.xyz/v1/search?q=dog&chain=solana&sortBy=holders&timeframe=1h&volumeMin=1000' -H 'Authorization: YOUR_API_KEY'
curl 'https://api.serialized.xyz/v1/search?q=intel&chain=solana&excludeCategories=stock,staked' -H 'Authorization: YOUR_API_KEY'
{
"data": [
{
"chain": "evm:8453",
"address": "0x4ed4e862860bed51a9570b96d89af5e1b0efefed",
"tokenAddress": "0x4ed4e862860bed51a9570b96d89af5e1b0efefed",
"poolAddress": "0x0ca6485b7e9cf814a3fd09d81672b07323535b64",
"name": "Degen",
"symbol": "DEGEN",
"decimals": 18,
"nameRank": 2,
"priceUsd": 0.0010305242898887457,
"liquidityUsd": 239687.07091684965,
"marketCapUsd": 37436168.14123417,
"volume24hUsd": 57125.74099077385,
"volume1hUsd": 1494.3552616863567,
"organicVolume24hUsd": null,
"priceChange1hPct": -0.10397104623411314,
"priceChange24hPct": 3.747121113042337,
"pool": {
"address": "0x0ca6485b7e9cf814a3fd09d81672b07323535b64",
"type": "UNISWAP_V3",
"factory": null,
"factoryAddress": "0x33128a8fc17869897dce68ed026d694621f6fdfd",
"launchpad": null,
"exchange": {
"name": "Uniswap V3",
"logo": "https://serialized.cloud/logos/dex/uniswap.680e6da3.svg"
}
},
"iconUrl": "https://serialized.cloud/token/6a2c16da-8530-4186-b2a8-9b54cc2d04cf/icon",
"socials": {
"website": "https://www.degen.tips",
"twitter": "https://x.com/degentokenbase",
"telegram": null,
"discord": null,
"links": null,
"uri": null
},
"listed": true,
"createdAt": 1705088299000,
"tokenCreatedAt": 1705088299000,
"poolCreatedAt": 1705088299000,
"lastTradeAt": 1794931157000,
"graduatedAt": null,
"launchpadPoolAddress": null,
"launchpadFactoryAddress": null,
"holdersCount": 1193360,
"bondingProgress": 0,
"migrated": false,
"creator": {
"address": "0xac937655e7b69934eaf0ef56a7f38ece1d74b451",
"launchedCount": null,
"migratedCount": null
},
"stats": {
"1h": { "volumeUsd": 1494.3552616863567, "feesUsd": 0.41, "buys": 9, "sells": 6, "txns": 15, "priceChangePct": -0.10397104623411314 },
"24h": { "volumeUsd": 57125.74099077385, "feesUsd": 14.87, "buys": 312, "sells": 251, "txns": 563, "priceChangePct": 3.747121113042337 }
},
"top10HoldersPct": 31.62,
"top25HoldersPct": 44.08,
"devHoldingsPct": null,
"top50HoldersPct": null,
"snipersHoldingsPct": null,
"bundlersHoldingsPct": null,
"insidersHoldingsPct": null,
"proTradersAllTimeCount": null,
"risk": {
"buyTaxBps": 0,
"sellTaxBps": 0,
"transferTaxBps": 0,
"isHoneypot": false,
"mintRevoked": null,
"freezeRevoked": null,
"transferPausable": false,
"balanceMutable": false,
"modifiableTax": false,
"isMintable": false,
"isBlacklisted": false,
"isNotOpenSource": false,
"selfDestruct": false,
"upgradeableProxy": false
},
"priceNativeAth": "0.0000182",
"priceUsdAth": 0.006747184078,
"marketCapAthUsd": 245107000.5,
"category": null
},
{
"chain": "evm:1",
"address": "0xbe92b510007bd3ec0adb3d1fca338dd631e98de7",
"tokenAddress": "0xbe92b510007bd3ec0adb3d1fca338dd631e98de7",
"poolAddress": "0xe0fe0440a7121a8815a49de4f15508123c4102e7",
"name": "Degen",
"symbol": "DEGEN",
"decimals": 18,
"nameRank": 63,
"priceUsd": 0.0000010794758137739666,
"liquidityUsd": 128072.76371509997,
"marketCapUsd": 161390.44514953013,
"volume24hUsd": 0,
"volume1hUsd": 0,
"organicVolume24hUsd": null,
"priceChange1hPct": null,
"priceChange24hPct": null,
"pool": {
"address": "0xe0fe0440a7121a8815a49de4f15508123c4102e7",
"type": "UNISWAP_V2",
"factory": null,
"factoryAddress": "0x5c69bee701ef814a2b6a3edd4b1652cb9cc5aa6f",
"launchpad": null,
"exchange": {
"name": "Uniswap V2",
"logo": "https://serialized.cloud/logos/dex/uniswap.680e6da3.svg"
}
},
"iconUrl": null,
"socials": {
"website": null,
"twitter": null,
"telegram": null,
"discord": null,
"links": null,
"uri": null
},
"listed": null,
"createdAt": 1683837491000,
"tokenCreatedAt": 1683837491000,
"poolCreatedAt": 1683837491000,
"lastTradeAt": 1794741959000,
"graduatedAt": null,
"launchpadPoolAddress": null,
"launchpadFactoryAddress": null,
"holdersCount": null,
"bondingProgress": 0,
"migrated": false,
"creator": null,
"stats": {
"1h": { "volumeUsd": 0, "feesUsd": 0, "buys": 0, "sells": 0, "txns": 0, "priceChangePct": null },
"24h": { "volumeUsd": 0, "feesUsd": 0, "buys": 0, "sells": 0, "txns": 0, "priceChangePct": null }
},
"top10HoldersPct": null,
"top25HoldersPct": null,
"devHoldingsPct": null,
"top50HoldersPct": null,
"snipersHoldingsPct": null,
"bundlersHoldingsPct": null,
"insidersHoldingsPct": null,
"proTradersAllTimeCount": null,
"risk": {
"buyTaxBps": null,
"sellTaxBps": null,
"transferTaxBps": null,
"isHoneypot": null,
"mintRevoked": null,
"freezeRevoked": null,
"transferPausable": false,
"balanceMutable": false,
"modifiableTax": false,
"isMintable": false,
"isBlacklisted": false,
"isNotOpenSource": false,
"selfDestruct": false,
"upgradeableProxy": false
},
"priceNativeAth": null,
"priceUsdAth": null,
"marketCapAthUsd": null,
"category": null
}
],
"meta": {
"asOf": 1786725099432,
"complete": true,
"hasMore": false
}
}
GET /v1/search · 5 credits
Token search by address, name or ticker, across any number of chains in one call. Results are ranked by relevance: the most significant token behind the text comes first. Native coins (ETH, SOL, BNB…) are part of the results. Sort by liquidity, market cap, volume, holders, all-time high or any figure of the row, and filter with the Screener’s filters. Results carry the token’s price, liquidity, market cap, 1h and 24h figures (volume, fees, buys, sells, transactions, price change), socials, holders, bonding progress, creator, taxes and token flags, and all-time high.
What you can type
q | Finds |
|---|---|
0x4ed4...efed, a Solana mint, a pool address | That token, on every chain asked where the address exists (every chain without chain); a pool address returns its token on that pool |
degen | Tokens whose ticker or name matches, best match first |
$DEGEN | Tokens whose ticker is exactly DEGEN |
ETH, SOL, BNB, ethereum | The native coin of each chain asked, first |
0x0000…0000, 0xeeee…eeee, So111…112 | The native coin of the chain |
Ranking
By default results are ranked by relevance. Relevance weighs how closely the text matches the ticker or the name with the depth and the 24h activity of the token’s market. A well-known token is found by its name as well as by its ticker:tether returns USDT, jupiter returns JUP.
sortBy replaces the ranking with a plain sort. It applies to the whole search, not to a page already cut, so it changes which tokens come back.
sortBy | Order |
|---|---|
relevance | Best match first (default) |
liquidity | Deepest market first |
marketCap | Highest market cap first |
volume | Highest volume over timeframe first (24h by default) |
volume1h | Highest 1h volume first |
newest | Most recent createdAt first |
holders | Most holders first (holdersCount; holdersCount and holders_count are accepted) |
| a field of the row | Any number of the row, highest first: priceNativeAth, priceUsdAth, marketCapAthUsd, priceUsd, nameRank, bondingProgress, stats.1h.feesUsd, windows.24h.txns… A bare counter (volumeUsd, feesUsd, buys, sells, txns, priceChangePct) reads timeframe; ageSeconds sorts like newest, reversed |
order=asc reverses any of them; a token whose sort value is unknown comes last in both orders. The volume sorts always consider the most traded tokens matching the text, whatever their liquidity: a small token with a large volume is not left out. top10HoldersPct, top25HoldersPct, top50HoldersPct, devHoldingsPct, snipersHoldingsPct, bundlersHoldingsPct, insidersHoldingsPct, proTradersAllTimeCount, the risk.* fields and the creator.* fields filter the results but are not sort keys (INVALID_PARAM on sortBy).
Chains
chain takes a list: chain=evm:1,evm:56,solana. EVM chains and Solana can be mixed in the same call. Without chain the search covers every chain. The list applies to an address as well: 0x4200000000000000000000000000000000000006 with chain=evm:57073 returns the WETH of Ink only.
Filters
filters takes the filter tree of the Screener, sent as URL-encoded JSON: { "<field>": { "<operator>": <value> } }, combined with AND, OR and NOT at any depth, with the same operators, the same field names and the same rule for unknown values (a token whose value is unknown never passes a numeric bound). The flat filters of the Screener work too, and combine with filters: liquidityMin, liquidityMax, marketCapMin, marketCapMax (USD), volumeMin, volumeMax, feesMin, feesMax (USD, over timeframe), txnsMin, txnsMax (over timeframe), ageMin, ageMax (minutes since the token’s first market), bondingMin, bondingMax, socials, factories, dexes (venue keys, see dexesByChain on GET /v1/meta/factories: the tokens whose market has no launchpad and runs on one of those venues; with factories, either), isOG=true (the first token that used its ticker on its chain) and excludeCategories (a list of token categories to leave out, below). Bounds are inclusive; a minimum above its maximum returns an empty list.
{
"name": { "contains": "pepe" },
"NOT": { "symbol": { "contains": "inu" } },
"risk.sellTaxBps": { "lte": 500 },
"windows.1h.volumeUsd": { "gte": 1000 },
"holdersCount": { "gte": 100 }
}
| Fields | |
|---|---|
| Identity | chain, address (the token, alias tokenAddress), name, symbol (keywords: contains, startsWith, endsWith, equals, ignoring letter case; NOT excludes), nameRank |
| Market | priceUsd, marketCapUsd, liquidityUsd, priceNativeAth, priceUsdAth, marketCapAthUsd |
| Age | createdAt, tokenCreatedAt, poolCreatedAt, graduatedAt, lastTradeAt (ms), ageSeconds |
| Activity | volumeUsd, feesUsd, buys, sells, txns, priceChangePct over timeframe, and each window as windows.1h.<field> or windows.24h.<field>, plus windows.1h.feesToVolumeRatio / windows.24h.feesToVolumeRatio (fees divided by volume, 0.002 = 0.2 %; Mobula name feesToVolumeRatio24h accepted) |
| Pool | pool.address (alias poolAddress), pool.type, pool.factory (the launchpad key) |
| Launchpad | bondingProgress, migrated |
| Links | metadata.iconUrl, metadata.websiteUrl, metadata.twitterUrl, metadata.telegramUrl |
| Holders | holdersCount, top10HoldersPct, top25HoldersPct, top50HoldersPct, devHoldingsPct, snipersHoldingsPct, bundlersHoldingsPct, insidersHoldingsPct, proTradersAllTimeCount |
| Creator | creator.address, creator.launchedCount, creator.migratedCount |
| Risk | risk.buyTaxBps, risk.sellTaxBps, risk.transferTaxBps, risk.isHoneypot, risk.transferPausable, risk.balanceMutable, risk.modifiableTax; on Solana risk.mintRevoked, risk.freezeRevoked; on EVM risk.isMintable, risk.isBlacklisted, risk.isNotOpenSource, risk.selfDestruct, risk.upgradeableProxy |
stats.<window>.<field>, volume24hUsd, volume1hUsd, priceChange1hPct, priceChange24hPct, iconUrl, socials.website, socials.twitter, socials.telegram, the Screener’s short names (factory, holders, top10, sellTaxBps…) and bonded, bondingPercentage, deployerTokensCount, deployerMigrationsCount.
A field the search rows do not carry is refused by name with INVALID_PARAM (details.param, details.field, details.reason), never ignored: totalSupply, circulatingSupply, priceNative, liquidityNative, metadata.dexPaid, the quote of the pool and the creator’s identity (filter them on GET /v1/screener), the other windows (windows.5m.*…), the wallet counts of a window (windows.1h.traders…), and snipers, proTraders, smartTraders, bundlers and insiders, with the same message as on the Screener. Filters apply to an exact address search too: q=<address> with a filter returns the token only when it passes.
timeframe (1h or 24h, default 24h) is the window of the bare counters (volumeUsd, feesUsd, buys, sells, txns, priceChangePct), of volumeMin, volumeMax, txnsMin, txnsMax, feesMin, feesMax, and of sortBy=volume.
Completeness
meta.complete is false when a token matching your filters may be missing from the page: the search looks at the best matches of the text, and a very common text, a sort by a figure (volume, holders, any field) or a narrow filter can leave tokens out, or a figure a filter reads was not available yet (retry after a few seconds). Narrow the text or the chains, or raise limit, to search deeper. meta.complete is also false when the holder figures (top10HoldersPct, top25HoldersPct, devHoldingsPct and the other holder and label fields) or the risk block of a row were not available yet: they are null on that row, and a retry after a few seconds serves them. meta.complete is true when nothing is missing.
Native coins
ETH, SOL, BNB and the other native coins come back as rows of their chain, with the same price, market cap, liquidity, volume and socials as /v1/token for the coin. They are served under the chain’s native address: 0x0000000000000000000000000000000000000000 on EVM chains (0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee is accepted as input) and the SOL mint So11111111111111111111111111111111111111112 on Solana, where 0x0000…0000 and 0xeeee…eeee also find SOL. On search rows a native coin’s pool is its main USD market, the same pool as on /v1/token. With a chain list, every chain listed that carries the coin gets its row; without chain, a coin present on several chains (ETH) comes back once, on its home chain.
A native coin carries its priceChange1hPct and priceChange24hPct: the coin’s USD price change over the last hour and the last 24 hours, the same change as /v1/token and /v1/token/stats. Wrapped native coins (WETH, WBNB…) carry the same change as their coin. A native coin’s createdAt is null: it has no trading pool of its own.
Majors and stablecoins
Majors, stablecoins and wrapped native coins (WETH, WBNB, USDC, USDT, UNI…) show the samepriceUsd, liquidityUsd, volume24hUsd and pool as /v1/token: their liquidity and volume cover their markets, not a single pool. A wrapped native coin is priced as one native coin.
Socials
Every row carriessocials: website, twitter, telegram and discord, https links or null, the same links as /v1/token/metadata (discord is its discordUrl); links, every other link of the token’s profile (TikTok, Reddit, GitHub, docs…), each { type, label, url }, the links of /v1/token/metadata (null when the token has no profile, [] when its profile has no other link); and uri, the token’s metadata URI (see the row fields). No extra call, no extra credit. Native coins, wrapped natives (WETH, WBNB…) and the main quote stablecoins of each chain (USDC, USDT, DAI…) carry the logo (iconUrl) and official links of their asset.
1h and 24h figures
Every row carriesstats.1h and stats.24h: volumeUsd and feesUsd (the fees paid by traders: network fees, plus validator tips and trading-terminal fees on Solana), buys, sells and txns, token-wide (every pool of the token: txns counts each transaction once, even when it trades through several of them or buys and sells in one go, so it can be lower than buys + sells; on Solana buys and sells count transactions too), and priceChangePct, the price change of the token’s main market (the row’s pool, the market of /v1/token). A token that did not trade in the window shows 0; a figure is null only when it is unknown. volume24hUsd, volume1hUsd, priceChange1hPct and priceChange24hPct are the same numbers as stats.24h.volumeUsd, stats.1h.volumeUsd, stats.1h.priceChangePct and stats.24h.priceChangePct.
Holders, launchpad and creator
Every row carries the same figures as the token’s own endpoints:| Field | Value |
|---|---|
holdersCount | Wallets holding the token, the same count as /v1/token/security. null when unknown |
top10HoldersPct, top25HoldersPct, top50HoldersPct | Shares of the supply held by the 10, 25 and 50 largest holders (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 figures of /v1/token/security (top50HoldersPct on Solana, null on EVM chains). null when unknown |
snipersHoldingsPct, bundlersHoldingsPct, insidersHoldingsPct, proTradersAllTimeCount | On Solana, the figures of the same names of /v1/token/security: the shares of the supply held now by the snipers, bundlers and insiders, and the number of pro traders who ever traded the token. null when unknown, and on EVM chains |
devHoldingsPct | Share of the supply held by creator.address. null when unknown |
bondingProgress | Launchpad bonding progress, 0 to 100, the launchpad.bondingProgress of /v1/token. 0 for a token that did not start on a launchpad |
migrated | true once the token graduated from its launchpad, the launchpad.migrated of /v1/token. false for a token that did not start on a launchpad |
graduatedAt | When the token graduated from its launchpad (ms), the launchpad.graduatedAt of /v1/token. null when it did not graduate or did not start on a launchpad |
launchpadPoolAddress | The token’s launchpad pool (its bonding curve), the launchpad.launchpadPoolAddress of /v1/token. null for a token that did not start on a launchpad, and for a launchpad without a curve market of its own |
launchpadFactoryAddress | The on-chain address that created the token’s bonding curve, the launchpad.factoryAddress of /v1/token: on EVM chains the curve’s factory contract, on Solana the launchpad’s program (6EF8rrecthR5Dkzon8Nwu78hRvfCKubJ14M5uBEwF6P for Pump.fun). null for a token that did not start on a launchpad, and for a launchpad without a curve market of its own |
pool.factoryAddress | The on-chain address that created the row’s pool, the pool.factoryAddress of /v1/token: on EVM chains the pool’s factory contract (the PoolManager on Uniswap V4 and its forks), on Solana the program of the pool’s venue. null when unknown. pool.factory is something else: the launchpad key |
socials.uri | The token’s metadata URI as published on-chain (https://, ipfs:// or ar://, as written), the metadata.uri of /v1/token. Solana: the mint’s metadata URI. EVM: published by some launchpads only, null for a token launched on a DEX and for a native coin |
creator.address | The wallet that created the token, the deployer of /v1/token. creator is null when unknown |
creator.launchedCount | Tokens this wallet created. EVM: every token, on a launchpad or not, across every EVM chain. Solana: its launchpad launches. null when none is recorded |
creator.migratedCount | Of those, the ones that graduated, null when launchedCount is |
holdersCount: null, bondingProgress: 0, migrated: false and creator: null; their holder shares, taxes and all-time high are null.
Token categories
Every row carriescategory, the category of its token in our asset registry, the same value as on the Screener rows: coin (a chain’s native coin and its wrapped or bridged versions, BTC), stablecoin, staked (liquid staking tokens, yield-bearing dollars), commodity (tokenized gold), stock (tokenized stocks and ETFs, pre-IPO shares) or token (a listed asset of no other kind); null when the token is in none of them, the case of most launchpad and DEX tokens. Native coins are coin. On Solana, the category also covers the tokens of Jupiter’s verified list by their tags.
excludeCategories leaves out the results of the listed categories, comma-separated among the six values above: q=intel&excludeCategories=stock finds the memecoins named after Intel, not the tokenized stock. A result with category: null is never left out. The exclusion applies to the whole search, like a filter: the page is refilled with the next matches, and meta.complete follows the usual rules. An unknown value is refused with INVALID_PARAM.
Taxes, token flags and all-time high
Every row carriesrisk, the token’s taxes and flags, the block of the Screener and Pulse rows: buyTaxBps, sellTaxBps, transferTaxBps in basis points, isHoneypot, transferPausable, balanceMutable, modifiableTax, on Solana mintRevoked, freezeRevoked, and on EVM chains the contract flags isMintable, isBlacklisted, isNotOpenSource, selfDestruct, upgradeableProxy (the values of /v1/token/security). A field that is not known is null, never a made-up 0 or false. A tax filter keeps only the tokens whose tax is known; when a tax is not known yet, meta.complete says so.
priceNativeAth (plain decimal text, in the chain’s native coin), priceUsdAth and marketCapAthUsd are the token’s all-time high, the same values as /v1/token. null when there is no credible high.
listed says whether CoinGecko lists the token, the metadata.listed of /v1/token: true, false, or null when unknown. Filter on it with filters={"metadata.listed":{"equals":true}} (alias listed).
Creation date
createdAt is when the token’s first trading pool opened, in milliseconds: the first market where the token trades, launchpad curve included, the same value as /v1/token. It is null on a native coin. ageSeconds and ageMin / ageMax count from it. tokenCreatedAt repeats it under the name of the Screener and Pulse rows; poolCreatedAt is the creation of the row’s pool and lastTradeAt its last trade (ms, null while it has not traded since its creation; on EVM chains a liquidity add or removal moves it too, as on the Screener and Pulse rows). lastTradeAt on /v1/token is another reading: the token’s latest swap across its markets. All four filter and sort, for example sortBy=lastTradeAt.
Pagination
limit is 1 to 50 (default 12). offset skips that many results before the page (default 0). A search pages down to its 50th result: offset is below 50 (INVALID_PARAM otherwise) and the page that reaches result 50 is served cut there (offset=40&limit=12 returns at most 10 results); a deeper page would widen the set of candidates the search reads. meta.offset echoes it, meta.hasMore says whether a result follows the page within those 50, and meta.nextOffset gives the next page’s offset whenever hasMore is true. Figures move between two calls, so two pages can repeat or skip a token.
volume24hUsd and volume1hUsd are token-wide - aggregated across every pool of the token. priceChange1hPct/priceChange24hPct follow the token’s main market, the one its price comes from, and are referenced to its close before each window. Majors, stablecoins and native coins show the volume of their markets, the same as /v1/token/stats.organicVolume24hUsd is the part of volume24hUsd that is not wash trading: a wallet that buys AND sells the token in the same transaction is excluded. Measured on Solana; null where it is not measured, and whenever volume24hUsd is null.marketCapUsd follows /v1/token: the circulating supply × price, where the circulating supply of a token outside the majors, stablecoins and native coins is its total supply minus the tokens held by burn addresses.pool is the token’s main market, the same pool /v1/token serves and the first row of /v1/token/pools. A row’s liquidityUsd is the liquidity of its pool (for majors, stablecoins and wrapped natives, of all their markets, as below), and liquidityMin, liquidityMax and sortBy=liquidity read it; /v1/token serves the token’s liquidity across its most traded markets. Searching a pool address returns its token on that pool, on every chain: pool is the pool searched, with its own liquidity. For a wrapped native coin it is the coin’s main USD market, as on /v1/token. pool.factory is the launchpad key of the registry, the same value as on /v1/token and /v1/pulse: a token that graduated from a launchpad keeps its launchpad; pool.factoryAddress is the on-chain address that created the pool. On a native coin, pool is its main USD market, the pool of /v1/token. tokenAddress repeats address and poolAddress repeats pool.address (null when pool is), as on every row (Identity fields).curl 'https://api.serialized.xyz/v1/search?q=degen' -H 'Authorization: YOUR_API_KEY'
curl 'https://api.serialized.xyz/v1/search?q=pepe&chain=evm:1,evm:56,solana&sortBy=volume&liquidityMin=10000' -H 'Authorization: YOUR_API_KEY'
curl 'https://api.serialized.xyz/v1/search?q=pepe&chain=solana&sortBy=volume1h' -H 'Authorization: YOUR_API_KEY'
curl 'https://api.serialized.xyz/v1/search?q=eth&chain=evm:1,evm:8453' -H 'Authorization: YOUR_API_KEY'
curl -G 'https://api.serialized.xyz/v1/search' -H 'Authorization: YOUR_API_KEY' \
--data-urlencode 'q=pepe' --data-urlencode 'chain=evm:8453,solana' \
--data-urlencode 'filters={"risk.sellTaxBps":{"lte":500},"holdersCount":{"gte":500},"NOT":{"symbol":{"contains":"inu"}}}'
curl 'https://api.serialized.xyz/v1/search?q=dog&chain=solana&sortBy=holders&timeframe=1h&volumeMin=1000' -H 'Authorization: YOUR_API_KEY'
curl 'https://api.serialized.xyz/v1/search?q=intel&chain=solana&excludeCategories=stock,staked' -H 'Authorization: YOUR_API_KEY'
{
"data": [
{
"chain": "evm:8453",
"address": "0x4ed4e862860bed51a9570b96d89af5e1b0efefed",
"tokenAddress": "0x4ed4e862860bed51a9570b96d89af5e1b0efefed",
"poolAddress": "0x0ca6485b7e9cf814a3fd09d81672b07323535b64",
"name": "Degen",
"symbol": "DEGEN",
"decimals": 18,
"nameRank": 2,
"priceUsd": 0.0010305242898887457,
"liquidityUsd": 239687.07091684965,
"marketCapUsd": 37436168.14123417,
"volume24hUsd": 57125.74099077385,
"volume1hUsd": 1494.3552616863567,
"organicVolume24hUsd": null,
"priceChange1hPct": -0.10397104623411314,
"priceChange24hPct": 3.747121113042337,
"pool": {
"address": "0x0ca6485b7e9cf814a3fd09d81672b07323535b64",
"type": "UNISWAP_V3",
"factory": null,
"factoryAddress": "0x33128a8fc17869897dce68ed026d694621f6fdfd",
"launchpad": null,
"exchange": {
"name": "Uniswap V3",
"logo": "https://serialized.cloud/logos/dex/uniswap.680e6da3.svg"
}
},
"iconUrl": "https://serialized.cloud/token/6a2c16da-8530-4186-b2a8-9b54cc2d04cf/icon",
"socials": {
"website": "https://www.degen.tips",
"twitter": "https://x.com/degentokenbase",
"telegram": null,
"discord": null,
"links": null,
"uri": null
},
"listed": true,
"createdAt": 1705088299000,
"tokenCreatedAt": 1705088299000,
"poolCreatedAt": 1705088299000,
"lastTradeAt": 1794931157000,
"graduatedAt": null,
"launchpadPoolAddress": null,
"launchpadFactoryAddress": null,
"holdersCount": 1193360,
"bondingProgress": 0,
"migrated": false,
"creator": {
"address": "0xac937655e7b69934eaf0ef56a7f38ece1d74b451",
"launchedCount": null,
"migratedCount": null
},
"stats": {
"1h": { "volumeUsd": 1494.3552616863567, "feesUsd": 0.41, "buys": 9, "sells": 6, "txns": 15, "priceChangePct": -0.10397104623411314 },
"24h": { "volumeUsd": 57125.74099077385, "feesUsd": 14.87, "buys": 312, "sells": 251, "txns": 563, "priceChangePct": 3.747121113042337 }
},
"top10HoldersPct": 31.62,
"top25HoldersPct": 44.08,
"devHoldingsPct": null,
"top50HoldersPct": null,
"snipersHoldingsPct": null,
"bundlersHoldingsPct": null,
"insidersHoldingsPct": null,
"proTradersAllTimeCount": null,
"risk": {
"buyTaxBps": 0,
"sellTaxBps": 0,
"transferTaxBps": 0,
"isHoneypot": false,
"mintRevoked": null,
"freezeRevoked": null,
"transferPausable": false,
"balanceMutable": false,
"modifiableTax": false,
"isMintable": false,
"isBlacklisted": false,
"isNotOpenSource": false,
"selfDestruct": false,
"upgradeableProxy": false
},
"priceNativeAth": "0.0000182",
"priceUsdAth": 0.006747184078,
"marketCapAthUsd": 245107000.5,
"category": null
},
{
"chain": "evm:1",
"address": "0xbe92b510007bd3ec0adb3d1fca338dd631e98de7",
"tokenAddress": "0xbe92b510007bd3ec0adb3d1fca338dd631e98de7",
"poolAddress": "0xe0fe0440a7121a8815a49de4f15508123c4102e7",
"name": "Degen",
"symbol": "DEGEN",
"decimals": 18,
"nameRank": 63,
"priceUsd": 0.0000010794758137739666,
"liquidityUsd": 128072.76371509997,
"marketCapUsd": 161390.44514953013,
"volume24hUsd": 0,
"volume1hUsd": 0,
"organicVolume24hUsd": null,
"priceChange1hPct": null,
"priceChange24hPct": null,
"pool": {
"address": "0xe0fe0440a7121a8815a49de4f15508123c4102e7",
"type": "UNISWAP_V2",
"factory": null,
"factoryAddress": "0x5c69bee701ef814a2b6a3edd4b1652cb9cc5aa6f",
"launchpad": null,
"exchange": {
"name": "Uniswap V2",
"logo": "https://serialized.cloud/logos/dex/uniswap.680e6da3.svg"
}
},
"iconUrl": null,
"socials": {
"website": null,
"twitter": null,
"telegram": null,
"discord": null,
"links": null,
"uri": null
},
"listed": null,
"createdAt": 1683837491000,
"tokenCreatedAt": 1683837491000,
"poolCreatedAt": 1683837491000,
"lastTradeAt": 1794741959000,
"graduatedAt": null,
"launchpadPoolAddress": null,
"launchpadFactoryAddress": null,
"holdersCount": null,
"bondingProgress": 0,
"migrated": false,
"creator": null,
"stats": {
"1h": { "volumeUsd": 0, "feesUsd": 0, "buys": 0, "sells": 0, "txns": 0, "priceChangePct": null },
"24h": { "volumeUsd": 0, "feesUsd": 0, "buys": 0, "sells": 0, "txns": 0, "priceChangePct": null }
},
"top10HoldersPct": null,
"top25HoldersPct": null,
"devHoldingsPct": null,
"top50HoldersPct": null,
"snipersHoldingsPct": null,
"bundlersHoldingsPct": null,
"insidersHoldingsPct": null,
"proTradersAllTimeCount": null,
"risk": {
"buyTaxBps": null,
"sellTaxBps": null,
"transferTaxBps": null,
"isHoneypot": null,
"mintRevoked": null,
"freezeRevoked": null,
"transferPausable": false,
"balanceMutable": false,
"modifiableTax": false,
"isMintable": false,
"isBlacklisted": false,
"isNotOpenSource": false,
"selfDestruct": false,
"upgradeableProxy": false
},
"priceNativeAth": null,
"priceUsdAth": null,
"marketCapAthUsd": null,
"category": null
}
],
"meta": {
"asOf": 1786725099432,
"complete": true,
"hasMore": false
}
}
Query Parameters
relevance (default), liquidity, marketCap, volume (over timeframe, 24h by default), volume1h (last hour), newest, holders (most holders first), or any number of the row: priceNativeAth, priceUsdAth, marketCapAthUsd, priceUsd, nameRank, bondingProgress, windows.1h.<field>, windows.24h.<field> (volumeUsd, feesUsd, buys, sells, txns, priceChangePct; a bare counter reads timeframe). The sort applies to the whole search, not to a page already cut: it changes which tokens come back. The volume sorts always consider the most traded tokens matching the text, whatever their liquidity. A token whose sort value is unknown comes last. The holder shares, risk.* and creator.* filter but do not sort.
Filter tree as URL-encoded JSON, the Screener's grammar: {"<field>":{"<operator>":<value>}}, combined with AND, OR and NOT. Operators: equals, not, in, gt, gte, lt, lte, contains, startsWith, endsWith. Fields: chain, address, name, symbol (keywords, ignoring letter case), nameRank, priceUsd, marketCapUsd, liquidityUsd, priceNativeAth, priceUsdAth, marketCapAthUsd, createdAt, tokenCreatedAt, poolCreatedAt, graduatedAt, lastTradeAt, ageSeconds, volumeUsd, feesUsd, buys, sells, txns, priceChangePct (over timeframe), windows.1h.<field>, windows.24h.<field>, pool.address, pool.type, pool.factory, bondingProgress, migrated, metadata.<iconUrl|websiteUrl|twitterUrl|telegramUrl|listed>, holdersCount, top10HoldersPct, top25HoldersPct, top50HoldersPct, devHoldingsPct, snipersHoldingsPct, bundlersHoldingsPct, insidersHoldingsPct, proTradersAllTimeCount, creator.<address|launchedCount|migratedCount>, risk.<buyTaxBps|sellTaxBps|transferTaxBps|isHoneypot|mintRevoked|freezeRevoked|transferPausable|balanceMutable|modifiableTax|isMintable|isBlacklisted|isNotOpenSource|selfDestruct|upgradeableProxy>. A field the rows do not carry is refused by name (INVALID_PARAM with details.field and details.reason), with the Screener's message.
CSV of token categories to leave out, among coin, stablecoin, staked, commodity, stock, token (the category of the rows, from the asset registry; on Solana also Jupiter's verified list by its tags). Applied to the whole search like a filter; a result whose category is null is never left out.
Response
Standard { data, meta } envelope.