# Contract Risk API – Full Check

> Contract Risk API – Full Check is a paid API for AI agents from smartcontractrisk.0xhodhod.xyz, paid per call via x402, $0.04/call, status unknown (last checked 2026-10-20).

Runs a comprehensive pre-trade safety scan on a smart contract or token address, returning risk scores, proxy/upgrade flags, and on-chain alert signals.

## Facts

- Endpoint: POST https://smartcontractrisk.0xhodhod.xyz/v1/full-check?utm_source=zero.xyz
- Price: $0.04/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-20
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/contract-risk-api-full-check-e0e26150
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_CxC4K-DtEN6474FnPFuGO

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 contract-risk-api-full-check-e0e26150 -d '<json body>'
```

Example prompt: Can you do a full safety check on the contract 0xd9aAEc86B65D86f6A7B5B1b0c42FFA531710b6CA on Base before I trade it — I want to know the risk score, whether it's an upgradeable proxy, and if there are any recent security alerts?

## When to prefer this

Choose this endpoint when you need a structured, multi-dimensional pre-trade risk score for a specific EVM contract before executing a DeFi trade or token purchase. It combines on-chain code analysis (proxy detection, upgrade patterns) with real-time social/alert monitoring in a single call. Prefer it over manual block explorer review or generic audit tools when you need machine-readable risk output for automated trading pipelines or agent-driven portfolio decisions on Base or Ethereum.

## Known failure modes

- Invalid or non-0x-prefixed address returns a validation error
- Address not found on the specified chain returns isContract: false with no flags
- Unsupported chain value returns a 422 or enum validation error
- Payment not settled via x402 USDC on Base returns HTTP 402 with a signed offer
- Network timeout or RPC unavailability on Base/Ethereum may cause delayed or failed responses

## How this service works

Pre-trade safety checks for smart contracts and tokens. All paid routes use the x402 'exact' scheme settling in USDC on Base (eip155:8453). Every 402 carries a signed offer and every 200 a signed receipt (EIP-712) — see /.well-known/x402 -> signing.

## Output

Returns a JSON object with a risk block (riskScore integer, riskLevel string, isProxy boolean, isContract boolean, and an array of labeled flags with weights), plus an alerts block showing mention counts across tracked on-chain channels broken down by category (securityAlert, whaleMovement, listing, other) and a note on data window coverage.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "chain": {
   "enum": [
    "base",
    "ethereum"
   ],
   "type": "string",
   "description": "Chain to query (default: base)"
  },
  "address": {
   "type": "string",
   "description": "0x-prefixed EVM contract address to scan"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "risk": {
   "flags": [
    {
     "label": "upgradeable proxy (EIP-1967) — logic can be swapped by admin",
     "weight": 10
    }
   ],
   "isProxy": true,
   "riskLevel": "medium",
   "riskScore": 10,
   "isContract": true
  },
  "chain": "base",
  "alerts": {
   "note": "No mentions in the current rolling window (last 30 messages per tracked channel). Absence of alerts is not a safety guarantee.",
   "channels": [],
   "categories": {
    "other": 0,
    "listing": 0,
    "securityAlert": 0,
    "whaleMovement": 0
   },
   "alertMentions": 0
  },
  "address": "0xd9aAEc86B65D86f6A7B5B1b0c42FFA531710b6CA"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/contract-risk-api-full-check-e0e26150/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from smartcontractrisk.0xhodhod.xyz](https://www.zero.xyz/host/smartcontractrisk.0xhodhod.xyz/llms.txt)