Get risk score

get

https://svc.cipherowl.ai/api/reason/v2/chains/{chain}/addresses/{address}/risk-score

Computes a deterministic 0–100 risk score for an address from its exposure profile. Use it for risk tiering, threshold-based alerting, and automated decisioning where a single comparable numeric value is more convenient than the categorical reason or breakdown views.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

chain

string

required

The blockchain network (e.g., bitcoin, evm, tron)

address

string

required

The blockchain address to analyze

Query Params

config

string

Selects the risk configuration (preconfigured risk model — categories,
hop depths, thresholds) to apply for this address. 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.

riskProfile

string

Risk profile name (e.g., "sanction_focused"). Uses default profile if empty.

hops

int32

Optional hop depth limit. Caps the max hops used for filtering risk results.
Must be between 0 and 8. When omitted, uses the config's default hops.

Responses

200A successful response.

defaultAn unexpected error response.