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/v1/api/wallet/monitor?wallet=0x...

Query parameters

wallet

string

required

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

chain

string

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

Response fields

wallet

string

required

The queried wallet address, echoed back in the response.

isMonitored

boolean

required

Whether this wallet is currently enrolled in continuous monitoring.

currentRiskScore

number

required

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

status

string

required

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

lastChecked

string

required

ISO 8601 timestamp of when NZOChain last scanned this wallet.

activeApprovals

number

required

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

alerts

object[]

required

A list of recent alert objects generated for this wallet.

Show alert properties

type

string

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

severity

string

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

message

string

Human-readable description of the detected threat.

detectedAt

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/v1/api/wallet/monitor \
  -H "Authorization: Bearer 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/v1/api/wallet/monitor?${params}`,
  {
    headers: {
      'Authorization': `Bearer ${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/v1/api/wallet/monitor',
    headers={
        'Authorization': f'Bearer {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

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