Usage Guidelines
- Pass an array of
{ address, networkId }objects to batch-fetch metadata for multiple tokens in a single request - Returns
EnhancedTokenobjects with rich metadata including name, symbol, decimals, and supply info infocontains token metadata likecirculatingSupply,totalSupply, and image URLs (thumb, small, large, banner)socialLinksprovides community-gathered links for Twitter, Discord, Telegram, website, and morelaunchpadis populated for tokens launched via platforms like pump.fun — includesgraduationPercentand completion statusisScamindicates whether the token has been flagged as potentially fraudulentcreatorAddress,createdAt, andcreateBlockNumberprovide token origin details
Troubleshooting Tips
When should I use tokens vs token?
When should I use tokens vs token?
Use
tokens (plural) when fetching metadata for multiple tokens at once — it accepts an array of token IDs and returns them in a single request. Use token (singular) when you only need one token and want a simpler query structure.When should I use tokens vs filterTokens?
When should I use tokens vs filterTokens?
Use
tokens when you already know the specific token addresses you want to look up — it’s a direct batch fetch by ID. Use filterTokens when you need to search or discover tokens based on criteria like market cap, volume, creation date, or other filters.What does the launchpad field contain?
What does the launchpad field contain?
launchpad is populated for tokens launched via bonding curve platforms (pump.fun, moonshot, etc.). It shows graduationPercent (progress toward migration), completed (whether it graduated), migratedAt (timestamp of migration), and poolAddress (the bonding curve pool).Why are some fields null?
Why are some fields null?
Not all tokens have complete metadata.
socialLinks, info, and launchpad may be null or have null subfields if the data hasn’t been collected or doesn’t apply. For example, launchpad is only populated for tokens launched via supported launchpad protocols.How do I get token images?
How do I get token images?
Token images are in the
info object: imageThumbUrl (small), imageSmallUrl (medium), imageLargeUrl (full size), and imageBannerUrl (wide banner). Not all tokens have images — check for null values.