POST /api/risk/scan — Wallet Threat Scan

Integração B2B canónica: API v1 (POST /api/v1/wallets/risk) com X-API-Key. Esta página é o caminho legado. URL correcto: https://api.nzochain.com/api/risk/scan. Só EVM nas quatro redes suportadas — não Solana.

The risk scan endpoint analyzes a wallet address and returns risk signals for product integrations that still use the legacy path.

Endpoint

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

Request body

string

required

Morada EVM (0x…) numa das quatro redes suportadas.

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.

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

number

required

A score from 0 to 100 representing the overall threat level of the wallet. Higher scores indicate greater risk.

string

required

Categorical threat status derived from the risk score. One of "SAFE", "WARNING", "HIGH RISK", or "CRITICAL".

string[]

required

A list of human-readable threat descriptions detected during the scan. Empty when no threats are found.

string

required

ISO 8601 timestamp indicating when the scan was performed, e.g., "2024-01-15T10:30:00Z".

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/api/risk/scan \
  -H "X-API-Key: pk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "wallet": "0x742d35Cc6634C0532925a3b8D4C9B5e55d7b1234",
    "chain": "ethereum",
    "include_details": true
  }'

const response = await fetch('https://api.nzochain.com/api/risk/scan', {
  method: 'POST',
  headers: {
    'X-API-Key': process.env.NZOCHAIN_API_KEY,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    wallet: '0x742d35Cc6634C0532925a3b8D4C9B5e55d7b1234',
    chain: 'ethereum',
    include_details: true,
  }),
});

const { riskScore, status, warnings } = await response.json();

if (status === 'HIGH RISK' || status === 'CRITICAL') {
  console.warn(`Wallet flagged: ${status} (score ${riskScore})`);
  console.warn('Warnings:', warnings);
}

import os
import requests

response = requests.post(
    'https://api.nzochain.com/api/risk/scan',
    headers={
        'X-API-Key': os.environ["NZOCHAIN_API_KEY"],
        'Content-Type': 'application/json',
    },
    json={
        'wallet': '0x742d35Cc6634C0532925a3b8D4C9B5e55d7b1234',
        'chain': 'ethereum',
        'include_details': True,
    },
)

result = response.json()
print(f"Risk score: {result['riskScore']} — {result['status']}")
for warning in result['warnings']:
    print(f"  • {warning}")

Overview

API v1 Firewall

Legacy endpoints

POST /api/risk/scan — Wallet Threat Scan

Endpoint

Request body

Example request

Response fields

Example response — HIGH RISK

Example response — SAFE

Code examples

​Endpoint

​Request body

​Example request

​Response fields

​Example response — HIGH RISK

​Example response — SAFE

​Code examples

Endpoint

Request body

Example request

Response fields

Example response — HIGH RISK

Example response — SAFE

Code examples