Batch screen

post

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

Screens many addresses in a single request against one risk configuration, returning an independent risk verdict for each address. Use it for bulk or periodic re-screening of large address lists (for example, a customer wallet base or a watchlist) where per-address round trips would be too slow.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

chain

string

required

The blockchain network where the addresses exist

Body Params

config

string

Selects the risk configuration (preconfigured risk model — categories,
hop depths, thresholds) to apply for every address in this batch.
Accepted values are moniker names such as co-defi, co-vasp,
co-institution. Prefix with co- to reference a CipherOwl-managed
configuration. An unprefixed name resolves against your organization's
customized configurations. When omitted or empty, the server resolves
your organization's default configuration for the requested chain and
returns the resolved name on the response. See
https://readme.cipherowl.ai/reference/parameters for the current list.

addresses

array of strings

The blockchain addresses to screen

namespace

string

Optional namespace for request attribution and reporting purposes.

hops

int32

Hop distance for multihop bloomfilter queries (0-8).
When set, uses multihop bloomfilter and checks all hops from 0 to this value.
When not set, uses legacy single-hop bloomfilter behavior.

trackAlert

boolean

Explicitly opt this request into alert tracking. Default/omitted is false.

Responses

200A successful response.

defaultAn unexpected error response.