# Aegis Smart Contract Quick Scan

> Aegis Smart Contract Quick Scan is a paid API for AI agents from api.tradeperpetua.xyz, paid per call via x402, $5/call, status down (last checked 2026-09-15).

Runs a fast static analysis and AI reasoning pass on a deployed smart contract to return a 0–100 risk score, verdict, and up to five findings with file and line references.

## Facts

- Endpoint: GET https://api.tradeperpetua.xyz/scan
- Price: $5/call
- Payment: x402
- Status: down
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/aegis-smart-contract-quick-scan-7855bb78
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_4RsGdwChX_Mf_CRqjeZZs

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 aegis-smart-contract-quick-scan-7855bb78
```

Example prompt: Can you do a quick security scan on the contract at 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 on Ethereum and tell me the risk score and any critical findings?

## When to prefer this

Use this endpoint when you need a fast, affordable ($5 USDC) security signal on a deployed contract across Base, Ethereum, Arbitrum, Optimism, Polygon, or BSC — especially when time matters more than exhaustive coverage. Prefer this over the full audit when you want a quick go/no-go verdict with top-line findings rather than a deep six-lens analysis. Ideal for pre-interaction checks, monitoring newly deployed contracts, or triaging contracts before committing to a full audit.

## Known failure modes

- Contract source not verified on-chain — scan is free but no findings returned
- Invalid or non-existent contract address returns an error
- Unsupported chain value returns validation error
- Contract fails to compile — scan is free, no results produced
- Network timeout or upstream analysis service unavailable
- Payment not received or insufficient USDC causes 402 response

## How this service works

Fast security verdict for a deployed contract on Base, Ethereum, Arbitrum, Optimism, Polygon or BSC. Static analysis plus one reasoning pass returns a 0 to 100 risk score, a verdict and up to five findings, each with a file and a line. Nothing is charged when the source is unverified or does not compile.

## Output

Returns a JSON object containing: a risk_score (0–100), a verdict enum (critical_risk, high_risk, caution, or looks_ok), a confidence level (high, medium, or low), a plain-English summary, and an array of up to five findings each with an id, title, severity (critical/high/medium/low/info), and a file:line location string. No charge is applied when the contract source is unverified or fails to compile.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "address"
     ],
     "properties": {
      "chain": {
       "enum": [
        "base",
        "ethereum",
        "arbitrum",
        "optimism",
        "polygon",
        "bsc"
       ],
       "type": "string",
       "default": "base",
       "description": "Chain, one of base, ethereum, arbitrum, optimism, polygon, bsc"
      },
      "address": {
       "type": "string",
       "pattern": "^0x[0-9a-fA-F]{40}$",
       "description": "Deployed contract address to audit"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "tier": {
       "enum": [
        "scan"
       ],
       "type": "string"
      },
      "summary": {
       "type": "string"
      },
      "verdict": {
       "enum": [
        "critical_risk",
        "high_risk",
        "caution",
        "looks_ok"
       ],
       "type": "string"
      },
      "findings": {
       "type": "array",
       "items": {
        "type": "object",
        "properties": {
         "id": {
          "type": "string"
         },
         "title": {
          "type": "string"
         },
         "location": {
          "type": "string",
          "description": "File.sol:LINE"
         },
         "severity": {
          "enum": [
           "critical",
           "high",
           "medium",
           "low",
           "info"
          ],
          "type": "string"
         }
        }
       }
      },
      "confidence": {
       "enum": [
        "high",
        "medium",
        "low"
       ],
       "type": "string"
      },
      "risk_score": {
       "type": "number",
       "description": "0 to 100, capped per severity band"
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/aegis-smart-contract-quick-scan-7855bb78/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.tradeperpetua.xyz](https://www.zero.xyz/host/api.tradeperpetua.xyz/llms.txt)