Wallet Sanctions Check

Direct wallet sanctions exposure check on Base. Screens a wallet and a bounded set of recent transfer counterparties, with evidence, coverage, and explicit limitations.

Resource: wallet-sanctions.use.x402atlas.com/exposure

Network: eip155:8453, eip155:137, eip155:42161, solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp · Asset: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 · Pay to: 0x8C128f1Ee62Bb5e47867CfbAe2ad89be325Df1b2

Payment methods: — · Last validation: 2026-09-14 16:35:04.653+00

{
  "input": {
    "type": "object",
    "required": [
      "type",
      "method"
    ],
    "properties": {
      "type": {
        "type": "string",
        "const": "http"
      },
      "method": {
        "enum": [
          "GET"
        ],
        "type": "string"
      },
      "queryParams": {
        "type": "object",
        "required": [
          "address",
          "network"
        ],
        "properties": {
          "address": {
            "type": "string",
            "maxLength": 42,
            "minLength": 42,
            "description": "A 20-byte EVM wallet address (0x...)."
          },
          "network": {
            "enum": [
              "eip155:8453"
            ],
            "type": "string",
            "description": "Base mainnet in CAIP-2 format."
          }
        }
      }
    },
    "additionalProperties": false
  },
  "output": {
    "type": "object",
    "required": [
      "type"
    ],
    "properties": {
      "type": {
        "type": "string"
      },
      "example": {
        "type": "object",
        "required": [
          "address",
          "network",
          "verdict",
          "recommended_action",
          "summary",
          "target",
          "coverage",
          "matches",
          "checked_at",
          "cached",
          "source",
          "limitations"
        ],
        "properties": {
          "cached": {
            "type": "boolean",
            "description": "True when the whole analysis was served from cache, including the pinned documentation example."
          },
          "source": {
            "type": "object",
            "required": [
              "check_type",
              "lists"
            ],
            "properties": {
              "lists": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "description": "Sanctions lists covered by the screening provider."
              },
              "check_type": {
                "enum": [
                  "direct_address_sanctions_exposure"
                ],
                "type": "string"
              }
            },
            "description": "What was checked and against which published lists."
          },
          "target": {
            "type": "object",
            "required": [
              "verdict",
              "is_sanctioned",
              "match",
              "checked_at",
              "cached"
            ],
            "properties": {
              "match": {
                "type": [
                  "object",
                  "null"
                ],
                "properties": {
                  "name": {
                    "type": "string",
                    "description": "Designated entity name as published by the source list."
                  },
                  "sanctioned_at": {
                    "type": "string",
                    "format": "date-time",
                    "description": "Designation date reported by the source list."
                  },
                  "listed_blockchain": {
                    "type": "string",
                    "description": "Chain the address was designated on, which may differ from the analyzed network."
                  }
                },
                "description": "Designation evidence for a positive target match; null when the target is not listed."
              },
              "cached": {
                "type": "boolean",
                "description": "True when the target screen was served from cache."
              },
              "verdict": {
                "enum": [
                  "sanctioned",
                  "not_listed"
                ],
                "type": "string",
                "description": "`not_listed` means no exact match was found, not AML clearance."
              },
              "checked_at": {
                "type": "string",
                "format": "date-time",
                "description": "When the target screen was obtained upstream; retained on cache hits."
              },
              "is_sanctioned": {
                "type": "boolean",
                "description": "True only for an exact match of the requested wallet."
              }
            },
            "description": "Exact-address screen of the requested wallet itself, independent of counterparty exposure."
          },
          "address": {
            "type": "string",
            "description": "Validated canonical EIP-55 address of the analyzed wallet."
          },
          "matches": {
            "type": "array",
            "items": {
              "type": "object",
              "examples": [
                {
                  "asset": "USDC",
                  "value": 5000,
                  "address": "0x000000000000000000000000000000000000dEaD",
                  "direction": "sent_to",
                  "sanctions": {
                    "name": "Placeholder Designated Entity",
                    "sanctioned_at": "2025-11-04T00:00:00Z",
                    "listed_blockchain": "Ethereum"
                  },
                  "transaction_hash": "0x0000000000000000000000000000000000000000000000000000000000000000",
                  "interaction_count": 3,
                  "latest_interaction": "2026-07-19T08:31:22Z"
                }
              ],
              "required": [
                "address",
                "direction",
                "interaction_count",
                "latest_interaction",
                "transaction_hash",
                "sanctions"
              ],
              "properties": {
                "asset": {
                  "type": "string",
                  "description": "Asset symbol of the most recent transfer (for example ETH or USDC); omitted when upstream reports none."
                },
                "value": {
                  "type": "number",
                  "description": "Decimal-adjusted amount of the most recent transfer denominated in `asset` — token units, NOT USD. Compare thresholds per asset."
                },
                "address": {
                  "type": "string",
                  "description": "Canonical EIP-55 address of the sanctioned counterparty."
                },
                "direction": {
                  "enum": [
                    "sent_to",
                    "received_from",
                    "bidirectional"
                  ],
                  "type": "string",
                  "description": "Flow direction relative to the requested wallet across the examined transfers."
                },
                "sanctions": {
                  "type": "object",
                  "properties": {
                    "name": {
                      "type": "string",
                      "description": "Designated entity name as published by the source list."
                    },
                    "sanctioned_at": {
                      "type": "string",
                      "format": "date-time",
                      "description": "Designation date reported by the source list."
                    },
                    "listed_blockchain": {
                      "type": "string",
                      "description": "Chain the address was designated on, which may differ from the analyzed network."
                    }
                  },
                  "description": "Designation evidence for this counterparty."
                },
                "transaction_hash": {
                  "type": "string",
                  "description": "Hash of the most recent such transfer, for on-chain verification."
                },
                "interaction_count": {
                  "type": "integer",
                  "description": "Number of examined transfers between the wallet and this counterparty."
                },
                "latest_interaction": {
                  "type": "string",
                  "format": "date-time",
                  "description": "Block timestamp of the most recent such transfer."
                }
              },
              "description": "A sanctioned counterparty plus the interaction evidence. The `examples` entry is an illustrative shape only: its address, hash, names, and dates are placeholders, not a real designation."
            },
            "description": "One entry per successfully screened counterparty that is an exact sanctions-list match; empty when none matched. An entry describes the counterparty, not the requested wallet."
          },
          "network": {
            "enum": [
              "eip155:8453"
            ],
            "type": "string",
            "description": "CAIP-2 network the analysis covers."
          },
          "summary": {
            "type": "string",
            "description": "Human-readable interpretation, including the coverage and AML-scope caveats."
          },
          "verdict": {
            "enum": [
              "target_sanctioned",
              "direct_exposure_detected",
              "no_direct_exposure_found"
            ],
            "type": "string",
            "description": "`target_sanctioned`: the requested wallet itself is an exact list match. `direct_exposure_detected`: the wallet is not listed but at least one screened counterparty is. `no_direct_exposure_found`: neither matched — read `coverage` before treating it as clean, because it is bounded by the reported limits and may be partial."
          },
          "coverage": {
            "type": "object",
            "required": [
              "from",
              "to",
              "lookback_days",
              "transfer_limit",
              "transfers_examined",
              "counterparty_limit",
              "counterparties_discovered",
              "counterparties_screened",
              "counterparties_failed",
              "counterparties_not_screened",
              "truncated",
              "provider_complete"
            ],
            "properties": {
              "to": {
                "type": "string",
                "format": "date-time",
                "description": "Newest transfer timestamp the scan considered."
              },
              "from": {
                "type": "string",
                "format": "date-time",
                "description": "Oldest transfer timestamp the scan considered."
              },
              "truncated": {
                "type": "boolean",
                "description": "True when a transfer or counterparty limit was hit, so the wallet has more history than was assessed."
              },
              "lookback_days": {
                "type": "integer",
                "description": "Configured history window in days."
              },
              "transfer_limit": {
                "type": "integer",
                "description": "Maximum transfers the scan reads before stopping."
              },
              "provider_complete": {
                "type": "boolean",
                "description": "False when any screen failed or an upstream transfer row was unusable. A negative verdict with `false` here is partial, not clean."
              },
              "counterparty_limit": {
                "type": "integer",
                "description": "Maximum unique counterparties this route screens per request."
              },
              "transfers_examined": {
                "type": "integer",
                "description": "Transfers actually read for this wallet."
              },
              "counterparties_failed": {
                "type": "integer",
                "description": "Counterparties whose screen was attempted but errored upstream. They are NOT clean — they are unknown."
              },
              "counterparties_screened": {
                "type": "integer",
                "description": "Counterparties whose sanctions screen completed successfully; only these carry a real result."
              },
              "counterparties_discovered": {
                "type": "integer",
                "description": "Unique counterparties found in the examined transfers."
              },
              "counterparties_not_screened": {
                "type": "integer",
                "description": "Discovered counterparties dropped by `counterparty_limit` and never sent upstream. Also unknown, not clean."
              }
            },
            "description": "Exactly what this analysis did. `counterparties_discovered` = `counterparties_screened` + `counterparties_failed` + `counterparties_not_screened`."
          },
          "checked_at": {
            "type": "string",
            "format": "date-time",
            "description": "When this analysis was assembled; retained on cache hits."
          },
          "limitations": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Scope caveats that constrain how this result may be used."
          },
          "recommended_action": {
            "enum": [
              "block_and_review",
              "manual_review",
              "no_direct_match"
            ],
            "type": "string",
            "description": "Suggested handling. `manual_review` is returned both for a counterparty match and for a negative result whose coverage is incomplete; `no_direct_match` only for a negative result with complete coverage."
          }
        }
      }
    }
  },
  "paymentRequirements": [
    {
      "raw": {
        "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
        "extra": {
          "name": "USD Coin",
          "tier": "standard",
          "version": "2",
          "merchant": "x402Atlas"
        },
        "payTo": "0x8C128f1Ee62Bb5e47867CfbAe2ad89be325Df1b2",
        "amount": "100000",
        "scheme": "exact",
        "network": "eip155:8453",
        "maxTimeoutSeconds": 300
      },
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "payTo": "0x8C128f1Ee62Bb5e47867CfbAe2ad89be325Df1b2",
      "scheme": "exact",
      "network": "eip155:8453",
      "amountAtomic": "100000"
    },
    {
      "raw": {
        "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
        "extra": {
          "name": "USD Coin",
          "tier": "standard",
          "version": "2",
          "merchant": "x402Atlas"
        },
        "payTo": "0x8C128f1Ee62Bb5e47867CfbAe2ad89be325Df1b2",
        "amount": "100000",
        "scheme": "exact",
        "network": "eip155:137",
        "maxTimeoutSeconds": 300
      },
      "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
      "payTo": "0x8C128f1Ee62Bb5e47867CfbAe2ad89be325Df1b2",
      "scheme": "exact",
      "network": "eip155:137",
      "amountAtomic": "100000"
    },
    {
      "raw": {
        "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
        "extra": {
          "name": "USD Coin",
          "tier": "standard",
          "version": "2",
          "merchant": "x402Atlas"
        },
        "payTo": "0x8C128f1Ee62Bb5e47867CfbAe2ad89be325Df1b2",
        "amount": "100000",
        "scheme": "exact",
        "network": "eip155:42161",
        "maxTimeoutSeconds": 300
      },
      "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
      "payTo": "0x8C128f1Ee62Bb5e47867CfbAe2ad89be325Df1b2",
      "scheme": "exact",
      "network": "eip155:42161",
      "amountAtomic": "100000"
    },
    {
      "raw": {
        "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
        "extra": {
          "tier": "standard",
          "feePayer": "GVJJ7rdGiXr5xaYbRwRbjfaJL7fmwRygFi1H6aGqDveb",
          "merchant": "x402Atlas"
        },
        "payTo": "ASt6xvRyQ7ntERsmcYVMdLqZvz1GEN8Fzexzq62tXrNQ",
        "amount": "100000",
        "scheme": "exact",
        "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
        "maxTimeoutSeconds": 300
      },
      "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
      "payTo": "ASt6xvRyQ7ntERsmcYVMdLqZvz1GEN8Fzexzq62tXrNQ",
      "scheme": "exact",
      "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
      "amountAtomic": "100000"
    }
  ]
}

Source catalog records are retained separately from live endpoint observations. Sonar score, uptime, and latency are advisory metrics. CDP indexing is not inferred from validation.