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

  1. Obtain your API token from the Tokens page.
  2. Send a GET request with the address or ENS name in the path:
   GET https://api.compliapi.com/api/v1/screen/crypto/{address}
  1. Include your token as a bearer header:
   Authorization: Bearer capi_...
  1. Read the response: sanctioned: true means a government sanctions list matched; flagged: true means any list matched, including crime-intelligence or risk-exposure lists.
  2. Check matches for 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.

← All articles

Powered by Shipstar