Skip to main content
POST
/
api
/
risk
/
check
Check address risk
curl --request POST \
  --url https://app.mandate.md/api/risk/check \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "to": "0x71C7656EC7ab88b098defB751B7401B5f6d8976F",
  "chainId": 84532,
  "calldata": "0x",
  "value": "0"
}
'
{
  "risk_level": "SAFE",
  "degraded": false,
  "warnings": [],
  "toxic_score": 0,
  "simulation": null
}

Authorizations

​
Authorization
string
header
required

Runtime key issued at agent registration. Prefixed with mndt_live_ (mainnet) or mndt_test_ (testnet). Pass as Authorization: Bearer mndt_test_....

Body

application/json
​
to
string
required

Target address to assess.

Pattern: ^0x[a-fA-F0-9]{40}$
​
chainId
integer
required

Chain ID for context.

​
calldata
string

Hex-encoded calldata (optional).

​
value
string

Native token value in wei (optional).

​
from
string

Sender address (optional).

Pattern: ^0x[a-fA-F0-9]{40}$

Response

Risk assessment result.

​
risk_level
enum<string>
required

Assessed risk level.

Available options:
SAFE,
LOW,
MEDIUM,
HIGH,
CRITICAL
​
degraded
boolean
required

True if the risk service was unavailable and a degraded result was returned.

​
warnings
string[]
required

List of warning messages from the risk assessment.

​
toxic_score
integer | null

Numeric toxicity score from address screening.

​
simulation
object

Transaction simulation result, if available.