# Wallet / Token / Contract Risk Snapshot (Base, Polygon)

> Wallet / Token / Contract Risk Snapshot (Base, Polygon) is a paid API for AI agents from twin.unykorn.org, paid per call via x402, $0.25/call, status unknown (last checked 2026-10-01).

Returns a machine-readable risk score and signal breakdown for a wallet, token, or contract address on Base or Polygon — suitable for pre-trade due diligence.

## Facts

- Endpoint: POST https://twin.unykorn.org/risk?utm_source=zero.xyz
- Price: $0.25/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-01
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/wallet-token-contract-risk-snapshot-base-polygon-9fc5fc33
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_I9NzrNhXclf_lWG5QULa_

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability wallet-token-contract-risk-snapshot-base-polygon-9fc5fc33 -d '<json body>'
```

Example prompt: Before I swap into this token, can you run a risk check on the contract 0x4ed4E00000000000000000000000000000000eFed on Base and tell me the verdict and any red flags?

## When to prefer this

Choose this endpoint when you need a structured, machine-readable, multi-signal risk assessment for a single EVM address on Base or Polygon — especially for pre-trade compliance checks, OFAC screening, or liquidity concentration analysis. It is purpose-built for agentic DeFi workflows where a JSON verdict with severity-tagged signals and an auditable evidence hash are required. Prefer it over generic blockchain explorers when you need a consolidated risk verdict rather than raw chain data.

## Known failure modes

- Invalid address format (not a valid 0x-prefixed 40-hex-character address) — likely returns a 400 or validation error
- Unsupported chain value (not 'base' or 'polygon') — enum validation error
- Payment failure via x402 protocol — no result returned
- Upstream data source (e.g. Blockscout) unavailable — partial signals or degraded result
- Address not found on-chain — result may still return with limited signals

## How this service works

Wallet / token / contract risk snapshot (Base, Polygon) — pre-trade check, machine-readable JSON — Genesis402 / UnyKorn Operator Network

## Output

A JSON object with: overall risk score (numeric), a verdict string (e.g. 'low_risk'), an array of named signals each with severity level (clear/info/warn/critical) and human-readable evidence, the subject's identified kind (wallet, token_contract, etc.), chain and address, a list of data sources queried, a tamper-evident evidence_hash, a payment receipt with tx_hash and receipt_id, and metadata like request_id and generated_at timestamp.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "params": {
   "type": "object",
   "properties": {
    "chain": {
     "enum": [
      "base",
      "polygon"
     ],
     "type": "string"
    },
    "address": {
     "type": "string",
     "pattern": "^0x[0-9a-fA-F]{40}$"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "type": "risk",
  "score": 0,
  "receipt": {
   "tx_hash": "0x<64hex>",
   "amount_usd": 0.25,
   "receipt_id": "g402-<16hex>"
  },
  "signals": [
   {
    "name": "screen:ofac_sdn_treasury",
    "evidence": "Not present on the OFAC SDN list (1046 digital-currency entries screened).",
    "severity": "clear"
   },
   {
    "name": "token:liquidity_concentration",
    "evidence": "Top 10 holders control 41.2% of supply.",
    "severity": "info"
   }
  ],
  "sources": [
   {
    "ok": true,
    "url": "https://base.blockscout.com/api/v2/addresses/0x…",
    "name": "blockscout_address"
   }
  ],
  "subject": {
   "kind": "token_contract",
   "chain": "base",
   "address": "0x4ed4…efed",
   "network": "eip155:8453"
  },
  "verdict": "low_risk",
  "request_id": "risk_<16hex>",
  "generated_at": "<iso8601>",
  "evidence_hash": "sha256:<64hex>"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/wallet-token-contract-risk-snapshot-base-polygon-9fc5fc33/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from twin.unykorn.org](https://www.zero.xyz/host/twin.unykorn.org/llms.txt)