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

# RiskVerdict

> A token's risk verdict. These values are not an ordered safety scale: `SCAM` and `VERIFIED` are terminal states reached by mechanical proof or a human decision, while `HIGH_RISK`, `CAUTION` and `NEUTRAL` are graded outcomes of weighted signals.

## GraphQL

```
enum RiskVerdict {
  SCAM
  HIGH_RISK
  CAUTION
  NEUTRAL
  VERIFIED
  VERIFIED_CONTESTED
}
```

### Used By

**Returned by**

* [balances](https://docs.codex.io/api-reference/queries/balances.md): Returns list of token balances that a wallet has.
* [categoryTokens](https://docs.codex.io/api-reference/queries/categorytokens.md): Returns the tokens assigned to a category (including its subcategories), with optional `filterTokens`-style filters and rankings applied.
* [filterPairs](https://docs.codex.io/api-reference/queries/filterpairs.md): Returns a list of pairs based on a variety of filters.
* [filterTokens](https://docs.codex.io/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](https://docs.codex.io/api-reference/queries/filtertokenwallets.md): Returns a list of wallets with stats narrowed down to a specific token.
* [getBars](https://docs.codex.io/api-reference/queries/getbars.md): Returns bar chart data to track price changes over time.
* [getCommunityNotes](https://docs.codex.io/api-reference/queries/getcommunitynotes.md): Returns community gathered notes.
* [getDetailedPairsStats](https://docs.codex.io/api-reference/queries/getdetailedpairsstats.md): Returns bucketed stats for a given token within a list of pairs.
* [getDetailedPairStats](https://docs.codex.io/api-reference/queries/getdetailedpairstats.md): Returns bucketed stats for a given token within a pair.
* [getTokenBars](https://docs.codex.io/api-reference/queries/gettokenbars.md): Returns aggregated bar chart data to track price changes over time.
* [holders](https://docs.codex.io/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](https://docs.codex.io/api-reference/queries/listpairsfortoken.md): Returns a list of pairs containing a given token.
* [listPairsWithMetadataForToken](https://docs.codex.io/api-reference/queries/listpairswithmetadatafortoken.md): Returns a list of pair metadata for a token.
* [onBalanceUpdated](https://docs.codex.io/api-reference/subscriptions/onbalanceupdated.md): Live-streamed balance updates for a given wallet. Updates left out by `networks` or `excludeTokens` are not charged.
* [onFilterTokensUpdated](https://docs.codex.io/api-reference/subscriptions/onfiltertokensupdated.md): Live-streamed filter token updates for the current `filterTokens` result set.
* [onHoldersUpdated](https://docs.codex.io/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](https://docs.codex.io/api-reference/subscriptions/onlaunchpadtokenevent.md): Live-streamed launchpad token event.
* [onLaunchpadTokenEventBatch](https://docs.codex.io/api-reference/subscriptions/onlaunchpadtokeneventbatch.md): Live-streamed launchpad token events batched (more efficient).
* [onPairMetadataUpdated](https://docs.codex.io/api-reference/subscriptions/onpairmetadataupdated.md): Live-streamed stat updates for a given token within a pair.
* [pairMetadata](https://docs.codex.io/api-reference/queries/pairmetadata.md): Returns metadata for a pair of tokens.
* [pairs](https://docs.codex.io/api-reference/queries/pairs.md): 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](https://docs.codex.io/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 (`<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](https://docs.codex.io/api-reference/queries/token.md): Returns a single token by its address & network id.
* [tokens](https://docs.codex.io/api-reference/queries/tokens.md): Returns a list of tokens by their addresses & network id, with pagination.

**Used as input by**

* [categoryTokens](https://docs.codex.io/api-reference/queries/categorytokens.md): Returns the tokens assigned to a category (including its subcategories), with optional `filterTokens`-style filters and rankings applied.
* [filterPairs](https://docs.codex.io/api-reference/queries/filterpairs.md): Returns a list of pairs based on a variety of filters.
* [filterTokens](https://docs.codex.io/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.
* [onFilterTokensUpdated](https://docs.codex.io/api-reference/subscriptions/onfiltertokensupdated.md): Live-streamed filter token updates for the current `filterTokens` result set.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.