Docs / OFAC SDN batch screen

How do I batch-screen up to 50 wallets against OFAC over x402?

Meridian by MioDio exact-matches 1 to 50 digital-currency addresses against public OFAC SDN entries in one POST for $0.10 USDC on Base via x402. It is informational only; invalid body after payment is not settled.

Request body

JSON body required:

Call it (curl + 402)

curl -i -X POST "https://meridian.miodiollc.com/v1/sanctions/batch" \
  -H 'content-type: application/json' \
  -d '{"addresses":["0x0000000000000000000000000000000000000001","0x098B716B8Aaf21512996dC57EB0615e2383E2f96"]}'

Route: POST /v1/sanctions/batch. Unpaid -> HTTP 402 + PAYMENT-REQUIRED. Retry with PAYMENT-SIGNATURE.

Paid 200 is a sanctions_batch card: product, card, version, results[] (each a sanctions_screen with address, chain, match, sdn_entries[] (name, program, list_date), list_version, list_updated_at, freshness_hours, sources, disclaimer, no_match_note, warnings), plus batch-level count, list_version, list_updated_at, freshness_hours, sources, disclaimer, no_match_note, and warnings.

Price vs single screen

$0.10 USDC on Base (~100000 atomic) for one batch of up to 50 addresses. Single screen is $0.005 per address. Network eip155:8453. Asset 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913. payTo 0x4DA1ED782BD61BaE9AdD5a5CaBbCf32f767f8d7F.

Errors and settlement rules

What it does NOT do

FAQ

How many addresses per call?
1 to 50 in one POST body (OpenAPI maxItems 50).
When am I charged?
Settlement only when the handler status is below 400. A 400 invalid_body after payment is not settled. 503 sanctions_list_unavailable is not settled.
Is batch cheaper than 50 single calls?
At list prices: 50 x $0.005 = $0.25 versus one batch at $0.10. Prices are the fixed USD amounts in OpenAPI; refresh on publish day.
Does no match clear the wallet?
No. Same informational caveat as the single screen. No match does not mean the wallet is clean.

Related