Token Safety Check (x402)

[
  {
    "error": "payment required",
    "accepts": [
      {
        "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
        "extra": {
          "name": "USD Coin",
          "version": "2"
        },
        "payTo": "0x54ebFCF3870439B9db62381848c5DabC05c70d5B",
        "amount": "30000",
        "scheme": "exact",
        "network": "eip155:8453",
        "maxTimeoutSeconds": 60
      }
    ],
    "resource": {
      "url": "https://x402.professorsausages.com/token-safety/check/:chain/:address",
      "tags": [
        "token-safety",
        "honeypot",
        "rug-check",
        "evm",
        "onchain"
      ],
      "mimeType": "application/json",
      "description": "Token safety & rug-pull/honeypot risk check — follows the proxy and scans the bytecode that actually runs, plus ownership, on Base/Ethereum",
      "serviceName": "Token Safety Check"
    },
    "extensions": {
      "help": {
        "docs": "https://x402.professorsausages.com/token-safety",
        "sample": "https://x402.professorsausages.com/token-safety/sample",
        "example": "https://x402.professorsausages.com/token-safety/check/base/0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
        "openapi": "https://x402.professorsausages.com/token-safety/openapi.json"
      },
      "bazaar": {
        "info": {
          "input": {
            "type": "http",
            "method": "GET"
          },
          "output": {
            "type": "object",
            "required": [
              "chain",
              "address",
              "found",
              "contract",
              "token",
              "risk_score",
              "verdict",
              "flags",
              "ownership",
              "reasons",
              "checks_run",
              "not_checked",
              "scan",
              "degraded",
              "disclaimer",
              "as_of_block"
            ],
            "properties": {
              "why": {
                "type": "object",
                "required": [
                  "code",
                  "detail"
                ],
                "properties": {
                  "code": {
                    "enum": [
                      "NOT_AN_ERC20"
                    ],
                    "type": "string"
                  },
                  "detail": {
                    "type": "string"
                  }
                },
                "description": "Present only when found is false."
              },
              "scan": {
                "type": "object",
                "required": [
                  "version",
                  "selectors_scanned"
                ],
                "properties": {
                  "version": {
                    "type": "string",
                    "description": "Which selector table produced this verdict, so two answers can be compared."
                  },
                  "selectors_scanned": {
                    "type": "integer"
                  }
                }
              },
              "chain": {
                "type": "string",
                "description": "Chain slug: base | ethereum."
              },
              "flags": {
                "type": [
                  "object",
                  "null"
                ],
                "required": [
                  "mintable",
                  "can_blacklist",
                  "pausable",
                  "has_fee_setter",
                  "upgradeable",
                  "owner_renounced"
                ],
                "properties": {
                  "mintable": {
                    "type": "boolean",
                    "description": "A mint/issue selector was found in the bytecode that actually runs — the implementation's, when the address is a proxy."
                  },
                  "pausable": {
                    "type": "boolean",
                    "description": "A pause() selector was found."
                  },
                  "verified": {
                    "type": "boolean",
                    "description": "Source-verification signal (not populated in v1)."
                  },
                  "upgradeable": {
                    "type": "boolean",
                    "description": "The code behind this address can be replaced (it is a proxy, or carries a deprecate/redirect switch), so capabilities absent today can appear later."
                  },
                  "can_blacklist": {
                    "type": "boolean",
                    "description": "A blacklist/denylist selector was found."
                  },
                  "has_fee_setter": {
                    "type": "boolean",
                    "description": "A fee/tax-setter selector was found."
                  },
                  "owner_renounced": {
                    "type": "boolean",
                    "description": "owner()/getOwner() POSITIVELY returned the zero address. An owner that is undeclared or unreadable is never reported as renounced — see `ownership`."
                  }
                },
                "description": "Null on a miss (the address is not an ERC-20, so there is nothing to flag)."
              },
              "found": {
                "type": "boolean",
                "description": "true when an ERC-20 was assessed. false when the address holds code that is not a token — a complete, paid answer with `why` explaining it and risk_score/verdict/flags null."
              },
              "token": {
                "type": "object",
                "required": [
                  "name",
                  "symbol",
                  "decimals",
                  "totalSupply"
                ],
                "properties": {
                  "name": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "symbol": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "decimals": {
                    "type": [
                      "integer",
                      "null"
                    ]
                  },
                  "totalSupply": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "description": "Stringified uint256 to avoid precision loss."
                  }
                }
              },
              "address": {
                "type": "string",
                "description": "The 0x token contract address (lowercased)."
              },
              "reasons": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "verdict": {
                "enum": [
                  "RISKY",
                  "CAUTION",
                  "NO_RED_FLAGS_FOUND",
                  "INCOMPLETE",
                  null
                ],
                "type": [
                  "string",
                  "null"
                ],
                "description": "Heuristic bucket. There is deliberately NO 'SAFE' value — absence of flags is not a guarantee. INCOMPLETE means a check the score depends on could not be completed (see `degraded`); null means the address is not a token."
              },
              "contract": {
                "type": "object",
                "required": [
                  "is_proxy",
                  "proxy_standard",
                  "implementation",
                  "scanned_address",
                  "scanned_bytecode_bytes"
                ],
                "properties": {
                  "is_proxy": {
                    "type": "boolean"
                  },
                  "implementation": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "description": "The contract this address delegates to (or its beacon), when proxied."
                  },
                  "proxy_standard": {
                    "enum": [
                      "erc1967",
                      "zeppelinos",
                      "erc1822",
                      "erc1167",
                      "beacon",
                      null
                    ],
                    "type": [
                      "string",
                      "null"
                    ],
                    "description": "Which proxy convention the implementation pointer was found under."
                  },
                  "scanned_address": {
                    "type": "string",
                    "description": "The address whose bytecode produced `flags` — the implementation for a proxy, the address itself otherwise."
                  },
                  "scanned_bytecode_bytes": {
                    "type": "integer"
                  }
                }
              },
              "degraded": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "check",
                    "code",
                    "detail"
                  ],
                  "properties": {
                    "code": {
                      "enum": [
                        "PROXY_IMPLEMENTATION_UNREADABLE",
                        "OWNERSHIP_UNREADABLE",
                        "TOKEN_PROFILE_UNREADABLE"
                      ],
                      "type": "string"
                    },
                    "check": {
                      "type": "string"
                    },
                    "detail": {
                      "type": "string"
                    }
                  }
                },
                "description": "Checks that could not be completed. Empty on a clean run; non-empty forces verdict INCOMPLETE unless a red flag was already found."
              },
              "ownership": {
                "type": "object",
                "required": [
                  "status",
                  "owner"
                ],
                "properties": {
                  "owner": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "status": {
                    "enum": [
                      "active",
                      "renounced",
                      "undeclared",
                      "unreadable"
                    ],
                    "type": "string",
                    "description": "active = a non-zero owner answered; renounced = the zero address answered; undeclared = owner() and getOwner() both revert (which is NOT the same as renounced, and is scored the same as active); unreadable = no RPC endpoint answered."
                  }
                }
              },
              "checks_run": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "disclaimer": {
                "type": "string"
              },
              "risk_score": {
                "type": [
                  "integer",
                  "null"
                ],
                "description": "0–100; higher = more privileged-control surface. Null on a miss."
              },
              "as_of_block": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Block height the reads were anchored against; null if it could not be read."
              },
              "not_checked": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "description": "Heuristics this scan does not perform — the full list, not a sample."
              }
            }
          }
        },
        "schema": {
          "type": "object",
          "required": [
            "input"
          ],
          "properties": {
            "input": {
              "type": "object"
            },
            "output": {
              "type": "object"
            }
          }
        },
        "category": "security",
        "routeTemplate": "https://x402.professorsausages.com/token-safety/check/:chain/:address"
      },
      "sample": {
        "url": "https://x402.professorsausages.com/token-safety/sample",
        "hint": "A real cached response from this API (with its capture timestamp), free — judge the data quality before paying."
      },
      "catalog": {
        "message": "You called Token Safety Check. Agents doing security work commonly also use these — same pay-per-call model, each with a FREE real sample record (freeSample link):",
        "related": [
          {
            "call": "/address-screen?ref=xsell&v=related&from=token-safety",
            "name": "Address Risk Screen",
            "summary": "Crypto address risk screening for agents",
            "freeSample": "/address-screen/sample?ref=xsell&v=related&from=token-safety"
          },
          {
            "call": "/sanctions-screen?ref=xsell&v=related&from=token-safety",
            "name": "OFAC Sanctions Name Screen",
            "summary": "Fuzzy OFAC name screening for agents with compliance duties",
            "freeSample": "/sanctions-screen/sample?ref=xsell&v=related&from=token-safety"
          },
          {
            "call": "/email-check?ref=xsell&v=related&from=token-safety",
            "name": "Email Deliverability Check",
            "summary": "Part of the Trust & Verification suite — verify anything, pay-per-check",
            "freeSample": "/email-check/sample?ref=xsell&v=related&from=token-safety"
          }
        ],
        "strategy": "related",
        "catalogUrl": "https://x402.professorsausages.com/?ref=402&v=related&from=token-safety"
      },
      "suggest": {
        "url": "https://x402.professorsausages.com/suggest",
        "hint": "Missing data you'd pay for? POST {want, would_pay_usd} — free. The most-requested datasets get built first."
      },
      "discount": {
        "off": "50%",
        "hint": "Send X-Intent: <40+ chars describing what you're building and what data you need> for 50% off this call.",
        "header": "X-Intent"
      }
    },
    "x402Version": 2
  }
]