scan.madhousewallet.com

{
  "properties": {
    "address": {
      "description": "The queried wallet address (checksummed or ENS-resolved).",
      "type": "string"
    },
    "addressExists": {
      "description": "True if the address has any on-chain transaction history.",
      "type": "boolean"
    },
    "ens": {
      "description": "Resolved ENS name if the address has one, otherwise null.",
      "type": [
        "string",
        "null"
      ]
    },
    "flaggedMetrics": {
      "description": "Risk signals that contributed to the score. Empty array means all 15 risk categories are clean.",
      "items": {
        "properties": {
          "description": {
            "type": "string"
          },
          "incomingMoneyUSD": {
            "description": "Flagged incoming USD (volume metrics only).",
            "type": "number"
          },
          "name": {
            "description": "Risk category name. Known values: known_scammer, sanction_address, blacklist, initiator_scam_transactions, suspicious_dex_pair_deployer, suspicious_deployer, attack_money_target, zero_address_risk, rug_pull, rug_pull_trader, sanction_address_communication, fake_phishing_contract_communication, fake_phishing_transfer, mixer_transfers, non_kyc_transfers.",
            "type": "string"
          },
          "outgoingMoneyUSD": {
            "description": "Flagged outgoing USD (volume metrics only).",
            "type": "number"
          },
          "risk": {
            "description": "Risk contribution. >0 means flagged.",
            "type": "number"
          },
          "txsCount": {
            "description": "Number of flagged transactions (volume metrics only).",
            "type": "number"
          },
          "type": {
            "description": "absolute = binary yes/no flag. volume = scaled by USD transaction volume.",
            "enum": [
              "absolute",
              "volume"
            ],
            "type": "string"
          }
        },
        "type": "object"
      },
      "type": "array"
    },
    "isContract": {
      "description": "True if the address is a smart contract, not an EOA.",
      "type": "boolean"
    },
    "riskLevel": {
      "description": "PASS = score 0; LOW = 0-0.40; MIDDLE = 0.41-0.80; CRITICAL >= 0.81.",
      "enum": [
        "PASS",
        "LOW",
        "MIDDLE",
        "CRITICAL"
      ],
      "type": "string"
    },
    "shouldFlag": {
      "description": "True if toxicScore > 0. Off-ramp compliance rule: only exact score 0 passes; any non-zero score must be flagged.",
      "type": "boolean"
    },
    "toxicScore": {
      "description": "Normalized risk score from 0 (clean) to 1 (critical). NOTE: the API may return scores as integers 0-100 for confirmed bad actors; always normalize with score > 1 ? score / 100 : score.",
      "type": "number"
    }
  },
  "required": [
    "address",
    "toxicScore",
    "riskLevel",
    "shouldFlag",
    "flaggedMetrics"
  ],
  "type": "object"
}