Wallet Sanctions Screening
On the HTTP APIScreen a crypto wallet address, such as an x402 payer, against the crypto addresses OFAC publishes. Exact match, source link, 1 cent per address.
Made for sellers who want to check the wallet that pays them before they serve the request. It is the wallet-address part of Sanctions Screening, as its own endpoint: the same lists, the same matching and the same rows, with the date of every list checked.
What it checks
- Addresses are matched exactly against the digital currency addresses OFAC publishes on its SDN and Consolidated lists (EVM
0x, bitcoin, Tron and the other kinds OFAC lists).0xandbc1addresses ignore upper and lower case; others must match as written. - Only lists that publish wallet addresses are checked, today OFAC. The UK, EU and UN lists do not publish addresses, so they cannot match one.
- It does not trace funds, cluster wallets or score risk. An address that is not listed is not a statement that it is clean.
HTTP API
$0.01 per wallet address screened (same rules as the addresses of sanctions-screening: an address no list could be checked against is free; so is a screen while a list could not be loaded, up to the daily limit; past it that screen is charged and marked incomplete) from prepaid credits (max 50 addresses per call). Get a key with a $5.00 free trial, or send the same call without a key and pay per call in USDC via x402.
curl https://api.boscolabs.dev/v1/wallet-screening \
-H "Authorization: Bearer $BOSCO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"addresses": ["0x7FF9cFad3877F21d41Da833E2F775dB0569eE3D9"]}'
OFAC data are US government works; no endorsement by OFAC implied. Exact address match only; funds are not traced. A screening aid, not a legal determination.
Example output
{
"query": "0x7ff9cfad3877f21d41da833e2f775db0569ee3d9",
"address": "0x7ff9cfad3877f21d41da833e2f775db0569ee3d9",
"chain": "ETH",
"match_found": true,
"match_count": 1,
"best_score": 100,
"summary": "Listed: ETH address of 'GARANTEX EUROPE OU' on the OFAC SDN List (entry 36025, programs CYBER4, RUSSIA-EO14024). An exact address match: do not transact before a compliance review.",
"complete": true,
"lists_not_checked": [],
"matches": [
{
"list": "ofac_sdn",
"entry_id": "36025",
"listed_name": "GARANTEX EUROPE OU",
"matched_identifiers": [
{"type": "Digital Currency Address - ETH", "value": "0x7FF9cFad3877F21d41Da833E2F775dB0569eE3D9"}
],
"match_type": "exact",
"entity_type": "organization",
"programs": ["CYBER4", "RUSSIA-EO14024"],
"countries": ["EE", "RU"],
"source_url": "https://sanctionssearch.ofac.treas.gov/Details.aspx?id=36025",
"list_version_date": "2026-11-06"
}
],
"lists_checked": [
{"list": "ofac_sdn", "list_name": "OFAC SDN List", "version_date": "2026-11-06", "addresses": 1081}
]
}
Input fields
| Field | Type | Meaning |
|---|---|---|
addresses | array (required) | Wallet addresses to screen, up to 50, one result row and one charge each. |
lists | array | Lists to check (default all); only ofac_sdn and ofac_consolidated publish addresses. |
Names, countries and fuzzy matching are on Sanctions Screening.