curl -X POST 'https://api.serialized.xyz/v1/token/metadata' \
-H 'Authorization: YOUR_API_KEY' -H 'Content-Type: application/json' \
-d '{"items":[{"chain":"evm:8453","address":"0x4ed4e862860bed51a9570b96d89af5e1b0efefed"},{"chain":"solana","address":"DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263"},{"chain":"solana","address":"11111111111111111111111111111112"}]}'
{
"data": [
{
"data": {
"chain": "evm:8453",
"address": "0x4ed4e862860bed51a9570b96d89af5e1b0efefed",
"tokenAddress": "0x4ed4e862860bed51a9570b96d89af5e1b0efefed",
"name": "Degen",
"symbol": "DEGEN",
"decimals": 18,
"iconUrl": "https://serialized.cloud/token/b278eb86-27e7-4fd3-ae7a-1014e2d1b60d/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
}
},
{
"data": {
"chain": "solana",
"address": "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
"tokenAddress": "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
"name": "Bonk",
"symbol": "Bonk",
"decimals": 5,
"iconUrl": "https://serialized.cloud/token/4b7ac198-4d41-460d-9d4a-e0a1aa399d4b/icon",
"headerUrl": "https://cdn.dexscreener.com/cms/images/e2667fc59737e727f0fd18e7e534c67e371ee40689068e72d30b5bc12bf63c2d?width=1500&height=500&quality=90",
"websiteUrl": "https://www.bonkcoin.com",
"twitterUrl": "https://twitter.com/bonk_inu",
"telegramUrl": "https://t.me/Official_Bonk_Inu",
"discordUrl": "https://discord.gg/qaQa6M6mN2",
"description": null,
"dexPaid": true,
"dexPaidAt": null,
"links": null,
"dexscreenerBoosted": false,
"coingeckoUrl": "https://www.coingecko.com/en/coins/bonk",
"listed": true,
"dexAdPaid": false,
"dexAdPaidAt": null,
"dexscreenerBoostedAt": null,
"dexscreenerBoostActive": false,
"dexscreenerListed": true
}
},
{
"error": {
"code": "NOT_FOUND",
"message": "Token 11111111111111111111111111111112 on solana"
}
}
],
"meta": {
"asOf": 1788980723721
}
}
Token Metadata
Token Metadata: batch
Batch twin: the metadata of up to 100 tokens in one call, EVM and Solana mixed freely. Response in input order, one slot per item, billed 1 credit per 25 items.
POST
/
v1
/
token
/
metadata
curl -X POST 'https://api.serialized.xyz/v1/token/metadata' \
-H 'Authorization: YOUR_API_KEY' -H 'Content-Type: application/json' \
-d '{"items":[{"chain":"evm:8453","address":"0x4ed4e862860bed51a9570b96d89af5e1b0efefed"},{"chain":"solana","address":"DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263"},{"chain":"solana","address":"11111111111111111111111111111112"}]}'
{
"data": [
{
"data": {
"chain": "evm:8453",
"address": "0x4ed4e862860bed51a9570b96d89af5e1b0efefed",
"tokenAddress": "0x4ed4e862860bed51a9570b96d89af5e1b0efefed",
"name": "Degen",
"symbol": "DEGEN",
"decimals": 18,
"iconUrl": "https://serialized.cloud/token/b278eb86-27e7-4fd3-ae7a-1014e2d1b60d/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
}
},
{
"data": {
"chain": "solana",
"address": "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
"tokenAddress": "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
"name": "Bonk",
"symbol": "Bonk",
"decimals": 5,
"iconUrl": "https://serialized.cloud/token/4b7ac198-4d41-460d-9d4a-e0a1aa399d4b/icon",
"headerUrl": "https://cdn.dexscreener.com/cms/images/e2667fc59737e727f0fd18e7e534c67e371ee40689068e72d30b5bc12bf63c2d?width=1500&height=500&quality=90",
"websiteUrl": "https://www.bonkcoin.com",
"twitterUrl": "https://twitter.com/bonk_inu",
"telegramUrl": "https://t.me/Official_Bonk_Inu",
"discordUrl": "https://discord.gg/qaQa6M6mN2",
"description": null,
"dexPaid": true,
"dexPaidAt": null,
"links": null,
"dexscreenerBoosted": false,
"coingeckoUrl": "https://www.coingecko.com/en/coins/bonk",
"listed": true,
"dexAdPaid": false,
"dexAdPaidAt": null,
"dexscreenerBoostedAt": null,
"dexscreenerBoostActive": false,
"dexscreenerListed": true
}
},
{
"error": {
"code": "NOT_FOUND",
"message": "Token 11111111111111111111111111111112 on solana"
}
}
],
"meta": {
"asOf": 1788980723721
}
}
POST /v1/token/metadata · 1 credit per 25 items
Batch twin: the metadata of up to 100 {chain, address} items in one call, EVM and Solana mixed freely. The response comes back 200 in input order, one slot per item: { data }, exactly the body of GET /v1/token/metadata for that token, or { error: { code, message } } for that item alone (unknown token, malformed address), never null. One bad item never costs you the rest of the lot. Billed 1 credit per 25 items served: 1 to 25 items cost 1 credit, 26 to 50 cost 2.
A slot’s
data is exactly what GET /v1/token/metadata returns: iconUrl and headerUrl are always fetchable https URLs (null when no image is available), dexPaid is true, false or null (status unknown), coingeckoUrl is the token’s CoinGecko page (null when it has none) and listed says whether CoinGecko lists the token (true, false, or null when unknown). The row ends with the DEX Screener products: dexAdPaid and dexAdPaidAt (an ad paid, and when the first was), dexscreenerBoostedAt (the first boost), dexscreenerBoostActive (a boost running now) and dexscreenerListed (a page on DEX Screener), each null when unknown.curl -X POST 'https://api.serialized.xyz/v1/token/metadata' \
-H 'Authorization: YOUR_API_KEY' -H 'Content-Type: application/json' \
-d '{"items":[{"chain":"evm:8453","address":"0x4ed4e862860bed51a9570b96d89af5e1b0efefed"},{"chain":"solana","address":"DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263"},{"chain":"solana","address":"11111111111111111111111111111112"}]}'
{
"data": [
{
"data": {
"chain": "evm:8453",
"address": "0x4ed4e862860bed51a9570b96d89af5e1b0efefed",
"tokenAddress": "0x4ed4e862860bed51a9570b96d89af5e1b0efefed",
"name": "Degen",
"symbol": "DEGEN",
"decimals": 18,
"iconUrl": "https://serialized.cloud/token/b278eb86-27e7-4fd3-ae7a-1014e2d1b60d/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
}
},
{
"data": {
"chain": "solana",
"address": "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
"tokenAddress": "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
"name": "Bonk",
"symbol": "Bonk",
"decimals": 5,
"iconUrl": "https://serialized.cloud/token/4b7ac198-4d41-460d-9d4a-e0a1aa399d4b/icon",
"headerUrl": "https://cdn.dexscreener.com/cms/images/e2667fc59737e727f0fd18e7e534c67e371ee40689068e72d30b5bc12bf63c2d?width=1500&height=500&quality=90",
"websiteUrl": "https://www.bonkcoin.com",
"twitterUrl": "https://twitter.com/bonk_inu",
"telegramUrl": "https://t.me/Official_Bonk_Inu",
"discordUrl": "https://discord.gg/qaQa6M6mN2",
"description": null,
"dexPaid": true,
"dexPaidAt": null,
"links": null,
"dexscreenerBoosted": false,
"coingeckoUrl": "https://www.coingecko.com/en/coins/bonk",
"listed": true,
"dexAdPaid": false,
"dexAdPaidAt": null,
"dexscreenerBoostedAt": null,
"dexscreenerBoostActive": false,
"dexscreenerListed": true
}
},
{
"error": {
"code": "NOT_FOUND",
"message": "Token 11111111111111111111111111111112 on solana"
}
}
],
"meta": {
"asOf": 1788980723721
}
}
Body
application/json
Response
200
Standard { data, meta } envelope.