RiskReasonCode

The reasons a risk verdict can cite. This vocabulary grows over time. Treat the list on a token as the reasons Codex can name today, not as a complete account of everything wrong with it.

PROOF_HONEYPOT_SIM · enum

PROOF_NON_TRANSFERABLE · enum

PROOF_TRANSFER_FEE_100 · enum

PROOF_DEFAULT_FROZEN · enum

PROOF_POOL_TRAP_SIM · enum

AUTH_MINT · enum

AUTH_FREEZE · enum

AUTH_PERMANENT_DELEGATE · enum

AUTH_TRANSFER_HOOK · enum

AUTH_PAUSABLE · enum

AUTH_OWNER_NOT_RENOUNCED · enum

AUTH_CAN_TRANSFER_OWNERSHIP · enum

TAX_BUY_HIGH · enum

TAX_SELL_HIGH · enum

TAX_HONEYPOT_UNCONFIRMED · enum

TAX_PAUSED · enum

TAX_POOL_TRAP · enum

TAX_POOL_TRAP_HOOK_SHARED · enum

LIQ_MINIMAL · enum

LIQ_UNKNOWN · enum

LIQ_RUG_CLIFF · enum

LIQ_UNLOCKED · enum

LIQ_DRAINING · enum

HOLD_TOP10_CONCENTRATED · enum

HOLD_DEV_HEAVY · enum

HOLD_SNIPER_HEAVY · enum

HOLD_BUNDLER_HEAVY · enum

HOLD_INSIDER_HEAVY · enum

HOLD_INSIDER_DUMPED · enum

The creator of a launchpad token sold or handed off a large share of supply in the token’s first hour.

FLOW_ONE_WAY · enum

FLOW_WALLET_FARM · enum

FLOW_WASH_DOMINATED · enum

FLOW_BUNDLED_LAUNCH · enum

FLOW_MECHANICAL_TRADING · enum

FLOW_RING_DOMINATED · enum

REP_SERIAL_RUGGER · enum

REP_RISKY_CREATOR · enum

REP_SCAMMER_FUNDED · enum

REP_IMITATOR_SYMBOL · enum

REP_IMITATOR_NAME · enum

REP_IMITATOR_IMAGE · enum

LABEL_MANUAL_SCAM · enum

LABEL_VERIFIED · enum

PROOF_PAUSED · enum · deprecated

This field is deprecated. Never emitted. An engaged pause is reported as TAX_PAUSED, a scored reason rather than proof, because a pause can be lifted. Use TAX_PAUSED instead.

PROOF_RUG_OCCURRED · enum · deprecated

This field is deprecated. Never emitted. A rug never forces SCAM. It will be reported as LIQ_RUG_OCCURRED, an informational liquidity reason that adds no points.

​

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.

Used as input by

• 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.
• onFilterTokensUpdated: Live-streamed filter token updates for the current filterTokens result set.