> ## Documentation Index > Fetch the complete documentation index at: https://docs.codex.io/llms.txt > Use this file to discover all available pages before exploring further. # tokens > Returns a list of tokens by their addresses & network id, with pagination. Some fields on this endpoint (`asset`, `assetDeployments`, `organization`) are powered by [The Grid](https://thegrid.id/) and will only be populated for established, verified tokens. See [Verified Metadata](/recipes/discover-tokens#verified-metadata) in the Discover Tokens recipe for full details.
## GraphQL ``` type Query { tokens( ids: [TokenInput!] ): [EnhancedToken]! } type SocialLinks { bitcointalk: String blog: String coingecko: String coinmarketcap: String discord: String email: String facebook: String github: String instagram: String linkedin: String reddit: String slack: String telegram: String twitch: String twitter: String website: String wechat: String whitepaper: String youtube: String } type TokenInfo { id: String! address: String! circulatingSupply: String cmcId: Int gridAssetId: String bluechipRating: String isScam: Boolean name: String networkId: Int! symbol: String! totalSupply: String imageThumbHash: String imageThumbUrl: String imageSmallUrl: String imageLargeUrl: String imageBannerUrl: String videoExternalUrl: String description: String } type OrganizationUrl { url: String! type: String } type OrganizationSocial { url: String! type: String } type AssetDeployment { id: String! networkId: Int! address: String! standard: String assetId: String! rootId: String! token: EnhancedToken } type Asset { id: String! name: String description: String ticker: String type: String status: String icon: String rootId: String! assetDeployments: [AssetDeployment!]! } type Organization { name: String! foundingDate: String descriptionShort: String descriptionLong: String tagLine: String type: String sector: String urls: [OrganizationUrl!]! socials: [OrganizationSocial!]! logo: String icon: String header: String rootId: String! assets: [Asset!]! } type ExplorerTokenData { id: String! blueCheckmark: Boolean description: String divisor: String tokenPriceUSD: String tokenType: String } type Exchange { id: String! address: String! color: String name: String exchangeVersion: String iconUrl: String networkId: Int! tradeUrl: String } enum WalletCategory { NORMIE TOKEN_CREATOR EXCHANGE DEFI_EXCHANGE PAIR PAIR_TOKEN_HOLDER POOL_AUTHORITY STAKING_VAULT NOTORIOUS } type WalletFunding { fundedByAddress: String! fundedByLabel: String fundedAt: Int! tokenAddress: String! networkId: Int! amount: String! transactionHash: String! } type WalletPolymarketProfile { proxyWallet: String! xUsername: String displayName: String pseudonym: String profileImageUrl: String verifiedBadge: Boolean displayUsernamePublic: Boolean fetchedAt: Int! } type Wallet { address: String! category: WalletCategory firstSeenTimestamp: Int firstFunding: WalletFunding identityLabels: [String!] avatarUrl: String displayName: String twitterId: String twitterUsername: String telegramId: String telegramUsername: String website: String discordId: String discordUsername: String githubId: String githubUsername: String farcasterId: String farcasterUsername: String description: String ethosScore: Int ethosLevel: String ethosVerified: Boolean identitySource: String identityUpdatedAt: Int polymarket: WalletPolymarketProfile tokensCreatedCount: Int tokensMigratedCount: Int } type LaunchpadData { launchpadName: String graduationPercent: Float poolAddress: String completedAt: Int completed: Boolean completedSlot: Int migratedSlot: Int migratedAt: Int migrated: Boolean migratedPoolAddress: String launchpadProtocol: String launchpadIconUrl: String isCashbackEnabled: Boolean category: String } type TokenExtrema { id: String! address: String! networkId: Int! athPrice: String! athPriceTimestamp: Int! atlPrice: String! atlPriceTimestamp: Int! athFdv: String! athFdvTimestamp: Int! atlFdv: String! atlFdvTimestamp: Int! athCircMc: String! athCircMcTimestamp: Int! atlCircMc: String! atlCircMcTimestamp: Int! } type CoinCommunity { id: String! createdAt: Int! postCount: Int! memberCount: Int! likeCount: Int! lastPostAt: Int } type Token2022ScaledUiAmountConfig { authority: String multiplier: Float! newMultiplierEffectiveTimestamp: String newMultiplier: Float } type Token2022Extensions { scaledUiAmountConfig: Token2022ScaledUiAmountConfig } type B20Extensions { multiplier: String multiplierObservedAt: String pausedTransfer: Boolean pausedMint: Boolean pausedBurn: Boolean supplyCap: String } type TokenExtensions { token2022: Token2022Extensions b20: B20Extensions } type Erc7572CustomInfo { type: String! featuredImage: String collaborators: [String!] } enum CategoryType { CANONICAL NARRATIVE } enum CategoryStatus { DRAFT ACTIVE ARCHIVED } type Category { id: String! name: String! shortName: String slug: String! description: String type: CategoryType! status: CategoryStatus! parentId: String memberCount: Int } type EnhancedToken { id: String! address: String! cmcId: Int decimals: Int! isScam: Boolean name: String networkId: Int! symbol: String socialLinks: SocialLinks info: TokenInfo gridAssetId: String bluechipRating: String organization: Organization asset: Asset exchanges: [Exchange!] creatorAddress: String creator: Wallet createBlockNumber: Int createTransactionHash: String createdAt: Int mintable: String freezable: String isFreezableValid: Boolean isMintableValid: Boolean launchpad: LaunchpadData top10HoldersPercent: Float profanity: Boolean extrema: TokenExtrema coinCommunity: CoinCommunity extensions: TokenExtensions tokenStandardCustomData: Erc7572CustomInfo categories: [Category!] } input TokenInput { address: String! networkId: Int! } ```
### Example Test this query in the Explorer → ```graphql theme={null} { tokens( ids: [ { address: "So11111111111111111111111111111111111111112", networkId: 1399811149 } { address: "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", networkId: 1399811149 } ] ) { address id name symbol decimals networkId isScam createdAt creatorAddress info { circulatingSupply totalSupply imageThumbUrl imageLargeUrl description } socialLinks { twitter website discord telegram } launchpad { launchpadName graduationPercent completed } } } ``` ### Usage Guidelines * Pass an array of `{ address, networkId }` objects to batch-fetch metadata for multiple tokens in a single request * Returns `EnhancedToken` objects with rich metadata including name, symbol, decimals, and supply info * `info` contains token metadata like `circulatingSupply`, `totalSupply`, and image URLs (thumb, small, large, banner) * `socialLinks` provides community-gathered links for Twitter, Discord, Telegram, website, and more * `launchpad` is populated for tokens launched via platforms like pump.fun — includes `graduationPercent` and completion status * `isScam` indicates token verification status — `isScam: false` is Codex's equivalent of a token being "verified". There is no separate `isVerified` field * `creatorAddress`, `createdAt`, and `createBlockNumber` provide token origin details ### Troubleshooting Tips 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. 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. `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). 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. 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.