Token Risk

​

Where to read it

​

Verdicts

​

Score

​

Coverage

​

Reasons

​

Freshness

​

Examples

​

Read one token

query TokenRisk {
  token(input: { address: "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2", networkId: 1 }) {
    symbol
    risk {
      verdict
      score
      coverage
      reasons
      flaggedAt
    }
  }
}

​

Hide risky tokens from a list

query SaferTokens {
  filterTokens(
    filters: { riskVerdicts: [NEUTRAL, VERIFIED], riskCoverages: [ANALYZED] }
    rankings: { attribute: volume24, direction: DESC }
    limit: 25
  ) {
    results {
      token {
        symbol
        risk {
          verdict
          score
        }
      }
    }
  }
}

​

Find likely honeypots among pairs

query HoneypotPairs {
  filterPairs(
    filters: { riskReasons: [PROOF_HONEYPOT_SIM, TAX_HONEYPOT_UNCONFIRMED] }
    rankings: { attribute: riskScore, direction: DESC }
    limit: 25
  ) {
    results {
      pair {
        address
        networkId
      }
      riskVerdict
      riskScore
      riskReasons
    }
  }
}

​

Get the actual tax numbers

1. Submit an analysis with simulateTokenContract. It returns a simulationId at once and the analysis runs in the background.
2. Read the outcome with getSimulateTokenContractResults, passing that simulationId, or subscribe to onSimulateTokenContract for the token.

mutation AnalyzeToken {
  simulateTokenContract(
    input: {
      simulateLiveContractInput: {
        contractAddress: "0x89d8cb38067b55f820f29a9e12d0ce18682a2bfc"
        networkId: 8453
      }
    }
  ) {
    result
    simulationId
    error
  }
}

query TokenTaxes {
  getSimulateTokenContractResults(
    contractAddress: "0x89d8cb38067b55f820f29a9e12d0ce18682a2bfc"
    networkId: 8453
    simulationId: "<simulationId from the mutation>"
  ) {
    results {
      status
      verdict
      verdictReason
      swap {
        buyTax
        sellTax
        buySuccess
        sellSuccess
      }
      liquidity {
        pairAddress
      }
    }
  }
}

• verdict is the answer: TRADEABLE, HONEYPOT, or INDETERMINATE with a verdictReason such as no sell route or an unsupported venue. status only tracks the pipeline, and buySuccess / sellSuccess are true on indeterminate rows too, so read verdict first.
• swap.buyTax and swap.sellTax are decimal fractions as strings. "0.05" is 5% and "1" is 100%. A honeypot usually shows sellTax: "1" with sellSuccess: false.
• liquidity.pairAddress is the pool the run traded through. Tax is a property of the pool, so two runs on the same token can differ when they route through different pools. On Uniswap V4 this is a 32-byte pool ID.
• A submission writes a PENDING row first. The finished result lands as a second row under the same uuid, usually within seconds. Read the row that has a verdict.
• Omit simulationId to read every stored analysis for the token, newest block first. An empty list means the token has never been analyzed, so submit one. Rows from before the 2026 rebuild can have status: FAILURE and no verdict.
• One submission per token and network every five minutes. A second one returns a TOO_MANY_REQUESTS error naming the retry time.

​

How this relates to isScam and potentialScam

• filterTokens hides tokens with isScam: true by default. Pass includeScams: true to include them, which you’ll need when filtering for SCAM verdicts.
• isVerified: true keeps only tokens with isScam: false. It isn’t the same as riskVerdicts: [VERIFIED].
• potentialScam and potentialScamReasons are an older automated flag. They’re still available, but risk is the more complete signal.