curl 'https://api.serialized.xyz/v1/token/metadata?chain=evm:8453&address=0x4ed4e862860bed51a9570b96d89af5e1b0efefed' -H 'Authorization: YOUR_API_KEY'
{
"data": {
"chain": "evm:8453",
"address": "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
},
"meta": {
"asOf": 1786725098674
}
}
Token Metadata
Token Metadata
Socials, description, images, dex-paid status. POST twin on the same path for batches (≤100, billed per item).
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",
"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
},
"meta": {
"asOf": 1786725098674
}
}
GET /v1/token/metadata · 1 credit
Socials, description, images, dex-paid status. POST twin on the same path for batches (≤100, billed per item).
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.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.curl 'https://api.serialized.xyz/v1/token/metadata?chain=evm:8453&address=0x4ed4e862860bed51a9570b96d89af5e1b0efefed' -H 'Authorization: YOUR_API_KEY'
{
"data": {
"chain": "evm:8453",
"address": "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
},
"meta": {
"asOf": 1786725098674
}
}