TokenExtensions

TokenExtensions is a GraphQL object type in the Codex API. See every field, its type, and which operations return it.

token2022 · Token2022Extensions

Solana Token-2022 extension metadata. See Token2022Extensions

Show Properties

scaledUiAmountConfig · Token2022ScaledUiAmountConfig

Scaled UI amount configuration for Token-2022 mints. See Token2022ScaledUiAmountConfig

Show Properties

authority · String

Authority allowed to update the scaled UI amount multiplier.

multiplier · Float!

Current multiplier applied to decimal-adjusted UI amounts.

newMultiplierEffectiveTimestamp · String

Unix timestamp when the pending multiplier becomes effective.

newMultiplier · Float

Pending multiplier, if one has been scheduled.

transferFeeConfig · Token2022TransferFeeConfig

Transfer fee schedules and authority for Token-2022 mints. See Token2022TransferFeeConfig

Show Properties

transferFeeConfigAuthority · String

Authority allowed to update transfer fees; null when revoked.

olderTransferFee · Token2022TransferFee!

Schedule used before newerTransferFee.epoch. See Token2022TransferFee

newerTransferFee · Token2022TransferFee!

Schedule used from newerTransferFee.epoch onwards. See Token2022TransferFee

b20 · B20Extensions

Base B20 extension metadata. See B20Extensions

Show Properties

multiplier · String

Current rebasing multiplier as a decimal string (e.g. “1.5”); absent means 1.0× or a non-asset variant.

multiplierObservedAt · String

Unix-seconds timestamp when the multiplier value was last read from chain by us.

pausedTransfer · Boolean

Whether token transfers are currently paused. B20 pausing is granular — transfers, mints, and burns pause independently.

pausedMint · Boolean

Whether minting is currently paused.

pausedBurn · Boolean

Whether burning is currently paused.

supplyCap · String

Maximum mintable supply in raw (pre-multiplier) units, as a decimal string. The sentinel value 340282366920938463463374607431768211455 (2^128-1) means uncapped.

robinhoodStockToken · RobinhoodStockTokenExtensions

Robinhood Chain stock token (tokenized equity) metadata. See RobinhoodStockTokenExtensions

Show Properties

uid · String!

Robinhood’s cross-chain asset id for the underlying equity.

multiplier · String

Multiplier in effect now, as a decimal string (e.g. “4.0” after a 4:1 split). Already reflects newMultiplier once newMultiplierEffectiveAt has passed.

multiplierObservedAt · String

Unix-seconds timestamp when the multiplier was last read from chain by us.

newMultiplier · String

Multiplier scheduled by a corporate action, as a decimal string. Stays set after it takes effect until our next read from chain.

newMultiplierEffectiveAt · String

Unix-seconds timestamp when newMultiplier takes effect.

oraclePaused · Boolean

Whether the token’s price oracle is paused.

xStock · XStockTokenExtensions

xStocks (Backed Finance tokenized equity) metadata, on EVM networks. Solana xStocks use token2022.scaledUiAmountConfig. See XStockTokenExtensions

Show Properties

multiplier · String

Multiplier in effect now, as a decimal string (e.g. “1.0017”). It grows as dividends are reinvested and jumps on a split. xStocks rebase: balances and transfer amounts already include it, so divide by it to get the token’s internal shares. Already reflects newMultiplier once newMultiplierEffectiveAt has passed.

multiplierObservedAt · String

Unix-seconds timestamp when the multiplier was last read from chain by us.

newMultiplier · String

Scheduled multiplier, as a decimal string. Stays set after it takes effect until our next read from chain.

newMultiplierEffectiveAt · String

Unix-seconds timestamp when newMultiplier takes effect.

​

Used By

Returned by

• balances: Returns list of token balances that a wallet has.
• categoryTokens: Returns the tokens assigned to a category (including its subcategories), with optional filterTokens-style filters and rankings applied.
• filterPairs: Returns a list of pairs based on a variety of filters.
• filterTokens: Discover, screen, and rank tokens across every supported network using 100+ on-chain signals: trading activity, liquidity, holder behavior, fee economics, and launchpad lifecycle.
• filterTokenWallets: Returns a list of wallets with stats narrowed down to a specific token.
• getBars: Returns bar chart data to track price changes over time.
• getCommunityNotes: Returns community gathered notes.
• getDetailedPairsStats: Returns bucketed stats for a given token within a list of pairs.
• getDetailedPairStats: Returns bucketed stats for a given token within a pair.
• getTokenBars: Returns aggregated bar chart data to track price changes over time.
• holders: Returns list of wallets that hold a given token, ordered by holdings descending. Also has the unique count of holders for that token.
• listPairsForToken: Returns a list of pairs containing a given token.
• listPairsWithMetadataForToken: Returns a list of pair metadata for a token.
• onBalanceUpdated: Live-streamed balance updates for a given wallet. Updates left out by networks or excludeTokens are not charged.
• onFilterTokensUpdated: Live-streamed filter token updates for the current filterTokens result set.
• onHoldersUpdated: Live-streamed list of wallets that hold a given token. Also has the unique count of holders for that token.
• onLaunchpadTokenEvent: Live-streamed launchpad token event.
• onLaunchpadTokenEventBatch: Live-streamed launchpad token events batched (more efficient).
• onPairMetadataUpdated: Live-streamed stat updates for a given token within a pair.
• pairMetadata: Returns metadata for a pair of tokens.
• pairs: Returns pairs by their IDs (address:networkId, or poolId:networkId for singleton pools such as Uniswap V4), in request order, with null for an ID that is not a known pair. Unlike filterPairs(pairs:), a token address is never expanded into its top pairs. At most 200 IDs.
• refreshBalances: Force refreshes the balance for a token in a wallet, persisting the result so subsequent balances queries reflect it. Supports contract tokens (<tokenAddress>:<networkId>, EVM only) and native token balances (native:<networkId>, EVM, Solana, and Starknet). Entries that cannot be refreshed (e.g. an unreachable network) are omitted from the response rather than erroring.
• token: Returns a single token by its address & network id.
• tokens: Returns a list of tokens by their addresses & network id, with pagination.