Wallet risk & sanctions screening API

Screen an EVM wallet address before paying it: checks the US Treasury OFAC sanctions list and reads on-chain behaviour (is it a contract, balance, activity) to return a 0–100 risk score, machine-readable flags, and a plain-English verdict. Answers 'is it safe to send funds to this address' in one call, on free public data.

Price$0.1per request

MethodPOST

Route/v1/chain/address-risk

StatusLive

MIME typeapplication/json

Rate limit60/minute

Cache300s public

chainforensicscompliancesanctionsofacwallet-riskkytcounterparty-risk

API URLhttps://x402.hexl.dev/v1/chain/address-risk

Integration docs

Example request

{
  "address": "0x0330070FD38Ec3bB94F58FA55D40368271E9e54A",
  "chain": "ethereum"
}

Example response

{
  "address": "0x0330070fd38ec3bb94f58fa55d40368271e9e54a",
  "chain": "ethereum",
  "sanctioned": true,
  "sanctionsSource": "OFAC SDN",
  "riskScore": 100,
  "riskLevel": "critical",
  "signals": {
    "isContract": false,
    "nativeBalance": "0.000000",
    "transactionCount": 0,
    "hasActivity": false
  },
  "flags": [
    "sanctioned:OFAC"
  ],
  "interpretation": "Address appears on the OFAC sanctions list. Do not transact — paying it may be illegal.",
  "methodology": "OFAC SDN sanctioned-address screening + on-chain metadata (balance, tx count, contract code) via public RPC.",
  "methodologyVersion": "chain-risk-2026.1",
  "checkedAt": "2026-06-02T00:00:00.000Z"
}

Input schema

{
  "type": "object",
  "required": [
    "address"
  ],
  "properties": {
    "address": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$",
      "examples": [
        "0x0330070FD38Ec3bB94F58FA55D40368271E9e54A"
      ]
    },
    "chain": {
      "type": "string",
      "enum": [
        "base",
        "ethereum"
      ],
      "default": "base"
    }
  }
}

Output schema

{
  "type": "object",
  "required": [
    "address",
    "chain",
    "sanctioned",
    "riskScore",
    "riskLevel",
    "signals",
    "flags",
    "interpretation",
    "methodologyVersion"
  ],
  "properties": {
    "address": {
      "type": "string"
    },
    "chain": {
      "type": "string"
    },
    "sanctioned": {
      "type": "boolean"
    },
    "sanctionsSource": {
      "type": [
        "string",
        "null"
      ]
    },
    "riskScore": {
      "type": "number",
      "minimum": 0,
      "maximum": 100
    },
    "riskLevel": {
      "type": "string",
      "enum": [
        "low",
        "medium",
        "high",
        "critical"
      ]
    },
    "signals": {
      "type": "object",
      "properties": {
        "isContract": {
          "type": "boolean"
        },
        "nativeBalance": {
          "type": "string"
        },
        "transactionCount": {
          "type": "number"
        },
        "hasActivity": {
          "type": "boolean"
        }
      }
    },
    "flags": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "interpretation": {
      "type": "string"
    },
    "methodology": {
      "type": "string"
    },
    "methodologyVersion": {
      "type": "string"
    },
    "checkedAt": {
      "type": "string"
    }
  }
}