TokenRisk

RiskVerdict

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

Show Properties

enum

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

enum

The weighted score reached the high-risk threshold.

enum

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

enum

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

enum

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

enum

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

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.

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.

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.

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

enum

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

enum

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

enum

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

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.

[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

enum

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

enum

Wallets run or sold by a bundling service bought the token. Informational: it adds no points. TokenRisk.bundlerServices names the services.

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.

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.

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.

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.

[BundlerService!]

The bundling services whose wallets bought the token, such as Proxima or Sumo. A fact about how the token launched, not a risk signal; when set, reasons includes FLOW_BUNDLER_SERVICE, without points, from the next scored assessment that is written. A terminal verdict (SCAM, VERIFIED, VERIFIED_CONTESTED) lists no scored reasons, and a token whose liquidity can’t be read keeps its last assessment, so either may not show it. Read at query time, so it can be newer than verdict; like every TokenRisk field it is unavailable while the token has no assessment. Null when no service is known to have bought the token, which is not proof that none did. See BundlerService

Show Properties

enum

Proxima, including wallets bought from its wallet shop.

enum

Sumo, including the wallets its paid campaigns trade from.

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.

API Documentation

Queries

Mutations

Subscriptions

Types

Used By

​Used By

Used By