GET /api/wallet/monitor — Monitoring Status

The wallet monitor endpoint returns the current monitoring status and the most recent threat summary for a given wallet address. Unlike the risk scan endpoint, which performs an on-demand analysis, this endpoint reads from NZOChain’s continuous monitoring system — giving you the latest cached risk data, active approval counts, and any recent alerts without consuming an additional scan call.

Endpoint

GET https://api.nzochain.com/api/wallet/monitor?wallet=0x...

Query parameters

string

required

The wallet address to retrieve monitoring status for. Accepts EVM addresses and Solana public keys.

string

Filter results to a specific chain, e.g., "ethereum" or "polygon". Omit to return data from all monitored chains.

Response fields

string

required

The queried wallet address, echoed back in the response.

boolean

required

Whether this wallet is currently enrolled in continuous monitoring.

number

required

The most recent RiskScore™ for this wallet, on a scale of 0 to 100.

string

required

Current threat status. One of "SAFE", "WARNING", "HIGH RISK", or "CRITICAL".

string

required

ISO 8601 timestamp of when NZOChain last scanned this wallet.

number

required

The number of active token approvals currently detected on this wallet.

object[]

required

A list of recent alert objects generated for this wallet.

Show alert properties

string

The category of the alert, e.g., "INFINITE_APPROVAL" or "MALICIOUS_CONTRACT".

string

Severity level: "LOW", "MEDIUM", "HIGH", or "CRITICAL".

string

Human-readable description of the detected threat.

string

ISO 8601 timestamp of when the alert was generated.

Example response

{
  "wallet": "0x742d35Cc6634C0532925a3b8D4C9B5e55d7b1234",
  "isMonitored": true,
  "currentRiskScore": 63,
  "status": "HIGH RISK",
  "lastChecked": "2024-01-15T10:28:00Z",
  "activeApprovals": 4,
  "alerts": [
    {
      "type": "INFINITE_APPROVAL",
      "severity": "HIGH",
      "message": "Infinite token approval granted to unverified contract",
      "detectedAt": "2024-01-15T09:45:00Z"
    },
    {
      "type": "SUSPICIOUS_INTERACTION",
      "severity": "MEDIUM",
      "message": "Interaction with contract flagged in threat intelligence feed",
      "detectedAt": "2024-01-14T17:22:00Z"
    }
  ]
}

Code examples

curl -G https://api.nzochain.com/api/wallet/monitor \
  -H "X-API-Key: pk_live_YOUR_API_KEY" \
  --data-urlencode "wallet=0x742d35Cc6634C0532925a3b8D4C9B5e55d7b1234" \
  --data-urlencode "chain=ethereum"

const params = new URLSearchParams({
  wallet: '0x742d35Cc6634C0532925a3b8D4C9B5e55d7b1234',
  chain: 'ethereum',
});

const response = await fetch(
  `https://api.nzochain.com/api/wallet/monitor?${params}`,
  {
    headers: {
      'X-API-Key': process.env.NZOCHAIN_API_KEY,
    },
  }
);

const data = await response.json();
console.log(`Monitored: ${data.isMonitored}, Score: ${data.currentRiskScore}`);

import os
import requests

response = requests.get(
    'https://api.nzochain.com/api/wallet/monitor',
    headers={
        'X-API-Key': os.environ["NZOCHAIN_API_KEY"],
    },
    params={
        'wallet': '0x742d35Cc6634C0532925a3b8D4C9B5e55d7b1234',
        'chain': 'ethereum',
    },
)

data = response.json()
print(f"Status: {data['status']}, Active approvals: {data['activeApprovals']}")

Wallet monitoring must be enabled before this endpoint returns data. Enable monitoring from the NZOChain dashboard under Wallets → Add Wallet, or by connecting a wallet via the dashboard. Once monitoring is active, this endpoint returns live risk data for the address.

Overview

API v1 Firewall

Legacy endpoints

GET /api/wallet/monitor — Monitoring Status

Endpoint

Query parameters

Response fields

Example response

Code examples

​Endpoint

​Query parameters

​Response fields

​Example response

​Code examples

Endpoint

Query parameters

Response fields

Example response

Code examples