> ## 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.

# 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".

<div data-generated>
  ## GraphQL

  ```
  type TokenRisk {
    verdict: RiskVerdict
    score: Float
    flaggedAt: Int
    coverage: RiskAnalysisCoverage
    reasons: [RiskReasonCode!]
  }

  enum RiskVerdict {
    SCAM
    HIGH_RISK
    CAUTION
    NEUTRAL
    VERIFIED
    VERIFIED_CONTESTED
  }

  enum RiskAnalysisCoverage {
    NOT_ANALYZED
    INCONCLUSIVE
    ANALYZED
  }

  enum RiskReasonCode {
    PROOF_HONEYPOT_SIM
    PROOF_NON_TRANSFERABLE
    PROOF_TRANSFER_FEE_100
    PROOF_PAUSED
    PROOF_DEFAULT_FROZEN
    PROOF_RUG_OCCURRED
    AUTH_MINT
    AUTH_FREEZE
    AUTH_PERMANENT_DELEGATE
    AUTH_TRANSFER_HOOK
    AUTH_PAUSABLE
    AUTH_OWNER_NOT_RENOUNCED
    AUTH_CAN_TRANSFER_OWNERSHIP
    TAX_BUY_HIGH
    TAX_SELL_HIGH
    TAX_HONEYPOT_UNCONFIRMED
    TAX_PAUSED
    LIQ_MINIMAL
    LIQ_UNKNOWN
    LIQ_RUG_CLIFF
    LIQ_UNLOCKED
    LIQ_DRAINING
    HOLD_TOP10_CONCENTRATED
    HOLD_DEV_HEAVY
    HOLD_SNIPER_HEAVY
    HOLD_BUNDLER_HEAVY
    HOLD_INSIDER_HEAVY
    FLOW_ONE_WAY
    FLOW_WALLET_FARM
    FLOW_WASH_DOMINATED
    FLOW_BUNDLED_LAUNCH
    FLOW_MECHANICAL_TRADING
    REP_SERIAL_RUGGER
    REP_RISKY_CREATOR
    REP_SCAMMER_FUNDED
    REP_IMITATOR_SYMBOL
    REP_IMITATOR_NAME
    LABEL_MANUAL_SCAM
    LABEL_VERIFIED
  }
  ```

  ### Used By

  **Returned by**

  * [balances](/api-reference/queries/balances.md): Returns list of token balances that a wallet has.
  * [categoryTokens](/api-reference/queries/categorytokens.md): Returns the tokens assigned to a category (including its subcategories), with optional `filterTokens`-style filters and rankings applied.
  * [filterPairs](/api-reference/queries/filterpairs.md): Returns a list of pairs based on a variety of filters.
  * [filterTokens](/api-reference/queries/filtertokens.md): 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](/api-reference/queries/filtertokenwallets.md): Returns a list of wallets with stats narrowed down to a specific token.
  * [getBars](/api-reference/queries/getbars.md): Returns bar chart data to track price changes over time.
  * [getCommunityNotes](/api-reference/queries/getcommunitynotes.md): Returns community gathered notes.
  * [getDetailedPairsStats](/api-reference/queries/getdetailedpairsstats.md): Returns bucketed stats for a given token within a list of pairs.
  * [getDetailedPairStats](/api-reference/queries/getdetailedpairstats.md): Returns bucketed stats for a given token within a pair.
  * [getTokenBars](/api-reference/queries/gettokenbars.md): Returns aggregated bar chart data to track price changes over time.
  * [holders](/api-reference/queries/holders.md): Returns list of wallets that hold a given token, ordered by holdings descending. Also has the unique count of holders for that token.
  * [listPairsForToken](/api-reference/queries/listpairsfortoken.md): Returns a list of pairs containing a given token.
  * [listPairsWithMetadataForToken](/api-reference/queries/listpairswithmetadatafortoken.md): Returns a list of pair metadata for a token.
  * [onBalanceUpdated](/api-reference/subscriptions/onbalanceupdated.md): Live-streamed balance updates for a given wallet.
  * [onFilterTokensUpdated](/api-reference/subscriptions/onfiltertokensupdated.md): Live-streamed filter token updates for the current `filterTokens` result set.
  * [onHoldersUpdated](/api-reference/subscriptions/onholdersupdated.md): Live-streamed list of wallets that hold a given token. Also has the unique count of holders for that token.
  * [onLaunchpadTokenEvent](/api-reference/subscriptions/onlaunchpadtokenevent.md): Live-streamed launchpad token event.
  * [onLaunchpadTokenEventBatch](/api-reference/subscriptions/onlaunchpadtokeneventbatch.md): Live-streamed launchpad token events batched (more efficient).
  * [onPairMetadataUpdated](/api-reference/subscriptions/onpairmetadataupdated.md): Live-streamed stat updates for a given token within a pair.
  * [pairMetadata](/api-reference/queries/pairmetadata.md): Returns metadata for a pair of tokens.
  * [refreshBalances](/api-reference/mutations/refreshbalances.md): Force refreshes the balance for a token in a wallet, persisting the result so subsequent `balances` queries reflect it. Supports contract tokens (`&lt;tokenAddress&gt;:&lt;networkId&gt;`, EVM only) and native token balances (`native:&lt;networkId&gt;`, EVM, Solana, and Starknet). Entries that cannot be refreshed (e.g. an unreachable network) are omitted from the response rather than erroring.
  * [token](/api-reference/queries/token.md): Returns a single token by its address & network id.
  * [tokens](/api-reference/queries/tokens.md): Returns a list of tokens by their addresses & network id, with pagination.
</div>