curl 'https://api.serialized.xyz/v1/token/metadata?chain=evm:8453&address=0x4ed4e862860bed51a9570b96d89af5e1b0efefed' -H 'Authorization: YOUR_API_KEY'
{
"data": {
"chain": "evm:8453",
"address": "0x4ed4e862860bed51a9570b96d89af5e1b0efefed",
"tokenAddress": "0x4ed4e862860bed51a9570b96d89af5e1b0efefed",
"name": "Degen",
"symbol": "DEGEN",
"decimals": 18,
"iconUrl": "https://serialized.cloud/token/3fb2e53c-a111-4cbd-abf5-787afcf59836/icon",
"headerUrl": "https://cdn.dexscreener.com/cms/images/b0bbfdf2aa7c44176f77b9e541ae3e247c358f0ee1aed5dbe171f5cd5f8f5cd1?width=1500&height=500&quality=90",
"websiteUrl": "https://www.degen.tips/",
"twitterUrl": "https://twitter.com/degentokenbase",
"telegramUrl": "https://t.me/degentokenbase",
"discordUrl": null,
"description": null,
"dexPaid": true,
"dexPaidAt": null,
"links": null,
"dexscreenerBoosted": false,
"coingeckoUrl": "https://www.coingecko.com/en/coins/degen-base",
"listed": true,
"dexAdPaid": false,
"dexAdPaidAt": null,
"dexscreenerBoostedAt": null,
"dexscreenerBoostActive": false,
"dexscreenerListed": true
},
"meta": {
"asOf": 1786725098674
}
}
Token Metadata
Token Metadata
Socials, description, images, dex-paid status. POST twin on the same path for batches (≤100, 1 credit per 25 items).
GET
/
v1
/
token
/
metadata
curl 'https://api.serialized.xyz/v1/token/metadata?chain=evm:8453&address=0x4ed4e862860bed51a9570b96d89af5e1b0efefed' -H 'Authorization: YOUR_API_KEY'
{
"data": {
"chain": "evm:8453",
"address": "0x4ed4e862860bed51a9570b96d89af5e1b0efefed",
"tokenAddress": "0x4ed4e862860bed51a9570b96d89af5e1b0efefed",
"name": "Degen",
"symbol": "DEGEN",
"decimals": 18,
"iconUrl": "https://serialized.cloud/token/3fb2e53c-a111-4cbd-abf5-787afcf59836/icon",
"headerUrl": "https://cdn.dexscreener.com/cms/images/b0bbfdf2aa7c44176f77b9e541ae3e247c358f0ee1aed5dbe171f5cd5f8f5cd1?width=1500&height=500&quality=90",
"websiteUrl": "https://www.degen.tips/",
"twitterUrl": "https://twitter.com/degentokenbase",
"telegramUrl": "https://t.me/degentokenbase",
"discordUrl": null,
"description": null,
"dexPaid": true,
"dexPaidAt": null,
"links": null,
"dexscreenerBoosted": false,
"coingeckoUrl": "https://www.coingecko.com/en/coins/degen-base",
"listed": true,
"dexAdPaid": false,
"dexAdPaidAt": null,
"dexscreenerBoostedAt": null,
"dexscreenerBoostActive": false,
"dexscreenerListed": true
},
"meta": {
"asOf": 1786725098674
}
}
GET /v1/token/metadata · 1 credit
Socials, description, images, dex-paid status. POST twin on the same path for batches (≤100, 1 credit per 25 items).
iconUrl is the token’s icon on our image CDN (serialized.cloud): a stable, lightweight WebP URL that never changes for a given token, safe to cache indefinitely and to load from a browser or a server. headerUrl is always a fetchable https URL (IPFS and Arweave pointers are resolved to a public gateway). null means no image is available. Native coins, wrapped natives (WETH, WBNB…) and the main quote stablecoins of each chain (USDC, USDT, DAI…) carry the logo of their asset (served from cdn.serialized.xyz) and its official website, X and Telegram links; their headerUrl, discordUrl, description, dexPaid and dexPaidAt are null.dexPaid is true, false, or null (status unknown); when our index has no record for a token, the status is resolved from DEX Screener’s listing records. dexPaidAt is the payment time in ms, or null.The other DEX Screener products close the row:
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 dexAdPaidAt is the time of its first ad payment, in ms. 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). dexscreenerBoostActive is true while a boost is running, false when none is, null when unknown. 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 native coins, wrapped natives and the main quote stablecoins, and are also in the metadata of /v1/token.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. dexscreenerBoosted is true once the token has been boosted on DEX Screener, false when it never was, null when unknown. Both are null on native coins, wrapped natives and the main quote stablecoins. The same fields are in the metadata of /v1/token.coingeckoUrl is the token’s page on CoinGecko, null when it has none. 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. The same two fields are in the metadata of /v1/token.curl 'https://api.serialized.xyz/v1/token/metadata?chain=evm:8453&address=0x4ed4e862860bed51a9570b96d89af5e1b0efefed' -H 'Authorization: YOUR_API_KEY'
{
"data": {
"chain": "evm:8453",
"address": "0x4ed4e862860bed51a9570b96d89af5e1b0efefed",
"tokenAddress": "0x4ed4e862860bed51a9570b96d89af5e1b0efefed",
"name": "Degen",
"symbol": "DEGEN",
"decimals": 18,
"iconUrl": "https://serialized.cloud/token/3fb2e53c-a111-4cbd-abf5-787afcf59836/icon",
"headerUrl": "https://cdn.dexscreener.com/cms/images/b0bbfdf2aa7c44176f77b9e541ae3e247c358f0ee1aed5dbe171f5cd5f8f5cd1?width=1500&height=500&quality=90",
"websiteUrl": "https://www.degen.tips/",
"twitterUrl": "https://twitter.com/degentokenbase",
"telegramUrl": "https://t.me/degentokenbase",
"discordUrl": null,
"description": null,
"dexPaid": true,
"dexPaidAt": null,
"links": null,
"dexscreenerBoosted": false,
"coingeckoUrl": "https://www.coingecko.com/en/coins/degen-base",
"listed": true,
"dexAdPaid": false,
"dexAdPaidAt": null,
"dexscreenerBoostedAt": null,
"dexscreenerBoostActive": false,
"dexscreenerListed": true
},
"meta": {
"asOf": 1786725098674
}
}
Query Parameters
Response
200
Standard { data, meta } envelope.