# Contract Risk API – Alert Check

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

Checks a smart contract address or token ticker for security alerts and whale movement mentions from monitored channels like whale_alert

## Facts

- Endpoint: POST https://smartcontractrisk.0xhodhod.xyz/v1/alert-check?utm_source=zero.xyz
- Price: $0.03/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-alert-check-80eaea67
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_jQOIL7S61eGTutv0cReqP

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-alert-check-80eaea67 -d '<json body>'
```

Example prompt: Before I trade, can you run a security alert check on the USDC contract address on Base and tell me how many whale movement or security alerts it has flagged?

## When to prefer this

Use this endpoint when you need a quick, pre-trade alert summary for a specific smart contract or token — particularly when you want to surface whale movement signals and security alerts from monitored social/alert channels. It is best suited for lightweight, on-demand safety checks rather than deep static code audits or full token scoring. Prefer this over general blockchain explorers when you specifically need aggregated alert channel mentions rather than raw transaction data.

## Known failure modes

- Invalid or unresolvable contract address returns an error or empty result
- Unsupported chain value returns a validation error
- Payment required (402) if x402 micropayment header is missing or incorrect
- Rate limiting or service unavailability may return 5xx errors
- Ticker not found in registry returns zero results rather than an error

## 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 the number of alert mentions across monitored channels (e.g. whale_alert), broken down by category (security alerts, whale movements, listings, other), the list of channels checked, and the timestamp of the last check.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "chain": {
   "enum": [
    "base",
    "ethereum"
   ],
   "type": "string",
   "description": "Chain hint (default: base)"
  },
  "address": {
   "type": "string",
   "description": "Contract address or search term (e.g. a ticker like USDC)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "chain": "base",
  "query": "USDC",
  "channels": [
   "whale_alert",
   "whale_alert_io"
  ],
  "categories": {
   "other": 0,
   "listing": 0,
   "securityAlert": 0,
   "whaleMovement": 14
  },
  "alertMentions": 14,
  "lastCheckedAt": "2026-10-14T12:19:44.073Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/contract-risk-api-alert-check-80eaea67/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)