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 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.

​
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"
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.