Deep ERC-20 rug/honeypot risk report with verdict API

Deep scam/honeypot risk report for an ERC-20 token contract: pulls the real holder list to compute top-1 and top-10 holder concentration (the single biggest pre-rug tell), parses the VERIFIED contract ABI for dangerous privileges (mint, blacklist/blocklist, pause, mutable fee/tax, trading-enable gate, max-tx/max-wallet limits, transferable ownership), reads owner() over public RPC to check renouncement, and folds in verification status, upgradeable-proxy detection, supply, and the explorer's own scam flag into a 0-100 risk score, a four-level verdict (likely_safe | caution | high_risk | likely_scam), machine-readable reason codes, and a plain-English narrative. Answers 'Is this token a rug?', 'Can the owner mint or blacklist me?', 'Does one wallet hold the whole float?', 'Is it safe to ape this memecoin?'.

Price$0.2per request

MethodPOST

Route/v1/chain/token-rug-check

StatusLive

MIME typeapplication/json

Rate limit60/minute

Cache600s public

chaintokenrughoneypotscamerc20memecoinriskholderssecurity

API URLhttps://x402.hexl.dev/v1/chain/token-rug-check

Integration docs

Example request

{
  "address": "0x4ed4e862860bed51a9570b96d89af5e1b0efefed",
  "chain": "base"
}

Example response

{
  "token": "0x4ed4e862860bed51a9570b96d89af5e1b0efefed",
  "chain": "base",
  "symbol": "DEGEN",
  "riskScore": 45,
  "verdict": "caution",
  "reasonCodes": [
    "OWNER_NOT_RENOUNCED",
    "MINT_FUNCTION",
    "PAUSE_FUNCTION",
    "ELEVATED_TOP1_CONCENTRATION"
  ],
  "privileges": [
    "mint",
    "pause",
    "ownership"
  ],
  "narrative": "CAUTION (risk 45/100). Owner can mint new supply, can pause transfers, ownership is transferable. Concentration top-1 23.4%, top-10 54.2%.",
  "facts": {
    "verified": true,
    "flaggedScam": false,
    "isProxy": false,
    "ownerRenounced": false,
    "holdersCount": 248311,
    "top1HolderShare": 0.234,
    "top10HolderShare": 0.5425
  },
  "disclaimer": "Best-effort structural rug/honeypot risk assessment from public explorer data and a bounded top-50 holder sample. Privilege detection relies on a VERIFIED ABI; unverified contracts are scored as opaque. NOT a buy/sell simulation and NOT financial advice. Verify before trading."
}

Input schema

{
  "type": "object",
  "required": [
    "address"
  ],
  "properties": {
    "address": {
      "type": "string",
      "description": "0x-prefixed 40-hex ERC-20 token contract address."
    },
    "chain": {
      "type": "string",
      "enum": [
        "base",
        "ethereum"
      ],
      "default": "base",
      "description": "Chain the token is deployed on."
    }
  },
  "examples": [
    {
      "address": "0x4ed4e862860bed51a9570b96d89af5e1b0efefed",
      "chain": "base"
    }
  ]
}

Output schema

{
  "type": "object",
  "additionalProperties": true
}