Docs / OFAC SDN exact-match screen

How do I screen a wallet against OFAC before my AI agent pays?

Meridian by MioDio exact-matches one digital-currency address against public OFAC SDN Digital Currency Address entries for $0.005 USDC on Base via x402. It is informational only. No match does not mean the wallet is clean.

What this check gives back

Paid JSON includes match (bool), sdn_entries[] (name, program, list_date), list_version, list_updated_at, freshness_hours, sources, disclaimer, no_match_note, and warnings. A paid 2xx may also carry a signed Meridian-Receipt header.

Call it (curl + 402 flow)

# Unpaid probe -> HTTP 402 + PAYMENT-REQUIRED
curl -i "https://meridian.miodiollc.com/v1/sanctions/0x098B716B8Aaf21512996dC57EB0615e2383E2f96"

# Free fixed demo (no payment)
curl -s "https://meridian.miodiollc.com/v1/demo/sanctions"

Route: GET /v1/sanctions/{address}. Optional query chain hints the OFAC Digital Currency chain (ETH, XBT, USDT, TRX, and others). ethereum/base map to ETH. Omit chain to exact-match the address across listed chains.

Unpaid calls return HTTP 402 with the PAYMENT-REQUIRED header and the same x402 v2 PaymentRequired object in the JSON body (x402Version, accepts, resource). Retry with PAYMENT-SIGNATURE after Exact USDC on Base.

Price and payment

$0.005 USDC on Base (~5000 atomic). Network eip155:8453. Asset Base USDC 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913. payTo 0x4DA1ED782BD61BaE9AdD5a5CaBbCf32f767f8d7F. No account. No API key. Invalid address is turned away before payment.

Limits and errors

Free demo

curl -s "https://meridian.miodiollc.com/v1/demo/sanctions"

Demo card (abridged, live 2026-11-05): match=true for a Lazarus Group sample address; sources=["OFAC SDN"]; no_match_note carries the required caveat.

{
  "card": "sanctions_screen",
  "version": "0.9.0",
  "address": "0x098b716b8aaf21512996dc57eb0615e2383e2f96",
  "match": true,
  "sdn_entries": [
    { "name": "LAZARUS GROUP", "program": "unspecified", "list_date": "10/28/2026" }
  ],
  "list_version": "10/28/2026",
  "sources": ["OFAC SDN"],
  "no_match_note": "No match does not mean the wallet is clean.",
  "warnings": []
}

What it does NOT do

FAQ

Is this a compliance tool?
No. It is an informational exact-match against the public OFAC SDN list only. Not legal or compliance advice, and not a substitute for a compliance program.
Does no match clear the wallet?
No. The response always includes that caveat. No match does not mean the wallet is clean. A miss is not clearance.
Where does the list come from?
Public U.S. Treasury OFAC SDN digital-currency addresses, with the ITA Consolidated Screening List as the official fallback. A worker cron refreshes a daily extract. See /health.sanctions and /llms.txt.
Do I need an API key?
No. Pay per call in USDC on Base via x402. No account.
What if the list is unavailable?
HTTP 503 sanctions_list_unavailable, and the call is not settled.

Related