Screen address

get

https://svc.cipherowl.ai/api/screen/v1/chains/{chain}/addresses/{address}

Screens a single blockchain address against a risk configuration and returns a fast yes/no risk verdict (found_risk). This is the lowest-latency SRR endpoint, intended for real-time compliance checks such as gating a deposit, withdrawal, or counterparty before a transaction is allowed.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

chain

string

required

Chain of the address, for example evm, bitcoin or tron. Risk is
evaluated per chain, so pass the chain, not a network such as
ethereum_mainnet. See https://readme.cipherowl.ai/reference/parameters#chain

address

string

required

The blockchain address to screen

Query Params

config

string

Risk configuration to apply, for example co-defi or co-vasp. co-
names a CipherOwl-managed config; an unprefixed name resolves against
your organization's. Omitted uses your default; the resolved name is
echoed on the response. See https://readme.cipherowl.ai/reference/parameters#config

reference

string

Opaque label for your own attribution, echoed on the response. Dot-separated
segments of [a-z0-9_], max 256 characters, trimmed and lowercased; anything
else returns 400. Does not affect screening. See https://readme.cipherowl.ai/reference/parameters#reference

hops

int32

Tracing depth, 0-8. Checks every hop from 0 to this value; omitted uses the
resolved configuration's default reach. See https://readme.cipherowl.ai/reference/parameters#hops

trackAlert

boolean

Set false to skip Case creation for this screening. Defaults to true.
See https://readme.cipherowl.ai/reference/parameters#track-alert

Response

200A successful response.