Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.nzochain.com/llms.txt

Use this file to discover all available pages before exploring further.

The risk scan endpoint analyzes a wallet address and returns a RiskScore™ between 0 and 100, a categorical threat status, and a list of specific warnings describing any detected threats. Use it to gate transactions, display risk indicators in your UI, or trigger downstream alerts in your application. Both EVM-compatible addresses (e.g., Ethereum, Polygon) and Solana addresses are supported.

​
Endpoint

POST https://api.nzochain.com/v1/api/risk/scan

​
Request body

​
wallet
string
required
The wallet address to scan. Accepts EVM addresses (starting with 0x) and Solana public keys.
​
chain
string
Chain identifier to scope the scan, such as "ethereum", "polygon", or "solana". When omitted, NZOChain auto-detects the chain based on the address format. Default: auto-detect.
​
include_details
boolean
default:"false"
When true, the response includes a detailed breakdown of individual contract interactions and token approvals that contributed to the score. Default: false.

​
Example request

{
  "wallet": "0x742d35Cc6634C0532925a3b8D4C9B5e55d7b1234",
  "chain": "ethereum",
  "include_details": true
}

​
Response fields

​
riskScore
number
required
A score from 0 to 100 representing the overall threat level of the wallet. Higher scores indicate greater risk.
​
status
string
required
Categorical threat status derived from the risk score. One of "SAFE", "WARNING", "HIGH RISK", or "CRITICAL".
​
warnings
string[]
required
A list of human-readable threat descriptions detected during the scan. Empty when no threats are found.
​
scannedAt
string
required
ISO 8601 timestamp indicating when the scan was performed, e.g., "2024-01-15T10:30:00Z".
​
chain
string
required
The chain on which the scan was performed, e.g., "ethereum".

​
Example response — HIGH RISK

{
  "riskScore": 87,
  "status": "HIGH RISK",
  "warnings": [
    "Infinite approval detected",
    "Malicious contract detected"
  ],
  "scannedAt": "2024-01-15T10:30:00Z",
  "chain": "ethereum"
}

​
Example response — SAFE

{
  "riskScore": 12,
  "status": "SAFE",
  "warnings": [],
  "scannedAt": "2024-01-15T10:30:00Z",
  "chain": "ethereum"
}

​
Code examples

curl -X POST https://api.nzochain.com/v1/api/risk/scan \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "wallet": "0x742d35Cc6634C0532925a3b8D4C9B5e55d7b1234",
    "chain": "ethereum",
    "include_details": true
  }'