Screen a crypto address or ENS name
Updated
The GET /screen/crypto/{address} endpoint checks a crypto address or ENS name against every enabled sanctions and crime list in a single call. It supports addresses on any chain — including BTC, ETH, TRX, XMR, USDT, and more — so you don't need separate lookups per network. If you pass a dotted ENS name like vitalik.eth, it is resolved to its underlying address before screening, and the resolved address is returned as value in the response.
How to screen an address
- Obtain your API token from the Tokens page.
- Send a GET request with the address or ENS name in the path:
GET https://api.compliapi.com/api/v1/screen/crypto/{address}
- Include your token as a bearer header:
Authorization: Bearer capi_...
- Read the response:
sanctioned: truemeans a government sanctions list matched;flagged: truemeans any list matched, including crime-intelligence or risk-exposure lists. - Check
matchesfor the list name, match type, source URL, and metadata for each hit.
Filtering by list
By default, every enabled list is checked. To narrow the scope, add a ?lists= query parameter with a comma-separated set of list slugs:
GET /api/v1/screen/crypto/0x094f1...?lists=ofac,eu_fsf
Valid slugs come from GET /screen/lists. An unknown slug returns a 400 error. The lists_checked field in the response always confirms which lists were actually evaluated.
Tornado Cash match metadata
When an address appears on the tornado_cash or tornado_cash_recipients list, the match includes extra metadata fields: role (either depositor, relayer, or recipient), pool (the pool size, e.g. 10 ETH), and tx_hash (the transaction that first linked the address to Tornado Cash). These hits set flagged: true but never sanctioned: true — they are risk-exposure signals, not government designations. The tornado_cash_recipients list is disabled by default because receiving a Tornado Cash withdrawal can result from a dusting attack rather than intentional use; depositor and relayer hits from tornado_cash reflect active mixer use and are a stronger signal.