TokenRisk

Codex’s unified risk assessment for a token. verdict is not a safety guarantee. VERIFIED means a human marked the token not-a-scam — a moderator judgement, not an allowlist — and NEUTRAL means the weighted score is below the caution threshold. Reasons can still be present on a neutral assessment. Neither says a token is safe to trade, and a clean assessment cannot see an un-armed trap (owner-pausable, blacklist-after-N-txs, upgradeable proxy). Read coverage before trusting anything else: NOT_ANALYZED means no contract analysis stands behind this verdict. Null fields indicate unavailable or inapplicable results as described below; they never mean “safe”.

verdict · RiskVerdict

The verdict. Null when the token has not been assessed. See RiskVerdict

Show Properties

SCAM · enum

Proven a scam by mechanical evidence, or labelled one by a human.

HIGH_RISK · enum

The weighted score reached the high-risk threshold.

CAUTION · enum

The weighted score reached the caution threshold but remains below high risk.

NEUTRAL · enum

The weighted score is below the caution threshold. Reasons may still be present. Not a statement that the token is safe.

VERIFIED · enum

A human marked this token not-a-scam. A moderator judgement, not an allowlist.

VERIFIED_CONTESTED · enum

Marked not-a-scam by a human, but mechanical signals disagree.

score · Float

Weighted score from 0 to 100, computed from weighted signals with family caps and a corroboration bonus, then clamped. Null for a terminal verdict reached without scoring, and for an unassessed token. Not a probability.

flaggedAt · Int

Unix seconds when the engine last recorded a change to this token’s risk assessment, the first recorded observation included. A re-evaluation that reaches the same result records nothing, so this tracks change rather than evaluation. Null when the token has never been assessed.

analyzedAt · Int

Unix seconds of the contract analysis the verdict rests on: the decisive analysis, or the newest reading of a proven trapped pool. Moves only when the contract is probed again, unlike flaggedAt. Null when neither stands behind the verdict.

coverage · RiskAnalysisCoverage

How much contract analysis stood behind the verdict. Null when unassessed, or when a terminal verdict was reached without establishing analysis coverage. See RiskAnalysisCoverage

Show Properties

NOT_ANALYZED · enum

No contract analysis stands behind this assessment. Not every token is analyzed; this says nothing about whether it is safe or taxed.

INCONCLUSIVE · enum

Analysis ran but reached no decisive verdict, for example because no supported venue could trade the token.

ANALYZED · enum

Analysis ran and reached a decisive verdict, or proved a pool of the token is a trap.

STALE · enum

The verdict rests on a tradeable analysis more than seven days old. A contract can change after it was probed. A honeypot proof never becomes stale.

reasons · [RiskReasonCode!]

The reason codes behind the verdict, unordered. Empty when nothing fired; null when unassessed. New codes are added over time, so do not assume this list is exhaustive or that a familiar set is the whole picture. See RiskReasonCode

Show Properties

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.

buyTax · Float

Buy tax measured on a simulated buy alone by the latest decisive contract analysis, as a fraction (0.05 means 5%). Pool, hook and launchpad platform fees are not included. Can be newer than verdict, which updates on the next assessment. Null when no decisive analysis could measure the buy on its own; null is not 0%. A Token-2022 fee as configured is in extensions.token2022.transferFeeConfig.

sellTax · Float

Sell tax measured on a simulated sell alone by the latest decisive contract analysis, as a fraction (0.05 means 5%). Pool, hook and launchpad platform fees are not included. Can be newer than verdict, which updates on the next assessment. Null when no decisive analysis could measure the sell on its own, including when that analysis found a honeypot: its test sale failed, so no sell tax was measured. Null is not 0%. A Token-2022 fee as configured is in extensions.token2022.transferFeeConfig.

​

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.