# Seneschal Puzzle/Bounty Contract Risk Feed

> Seneschal Puzzle/Bounty Contract Risk Feed is a paid API for AI agents from api.seneschal.space, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-14).

Returns an annotated watchlist of on-chain puzzle, CTF, and bounty contracts classified by payout risk (locked, front-run bait, owner-only, claimable, etc.) with ETH at stake and front-run verdicts.

## Facts

- Endpoint: GET https://api.seneschal.space/v1/premium/puzzle-risk
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/seneschal-puzzle-bounty-contract-risk-feed-839ca79f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_9VRotgGf_WEEcn3XOGlOF

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 seneschal-puzzle-bounty-contract-risk-feed-839ca79f
```

Example prompt: Show me all currently funded Ethereum puzzle and CTF contracts that are front-run bait — I want to see which ones will get sandwiched if I broadcast a solution publicly, with how much ETH is at stake for each.

## When to prefer this

Use this endpoint when an agent or researcher needs to evaluate on-chain Ethereum puzzle, CTF, or bounty contracts before attempting to solve or claim them — specifically to detect front-run risk, locked/unclaimable value, or owner-gated payouts. Prefer this over generic contract analysis tools when the specific risk taxonomy (locked_no_payout, frontrun_bait, etc.) and ETH-at-stake data is needed for automated decision-making about whether to attempt a contract solution.

## Known failure modes

- Invalid classification value returns 400 or empty result set
- Payment not provided or invalid x402 payment header returns 402 Payment Required
- limit exceeds maximum of 1000 — capped silently or returns error
- funded_only with non-boolean-like value may be ignored or cause 400
- Service unavailable or upstream chain data stale returns 503 or stale as_of_ms

## How this service works

Puzzle / bounty contract risk feed: the annotated watchlist of puzzle/CTF/bounty contracts classified as locked_no_payout (funded but value can never leave — solving pays nothing), frontrun_bait (pays msg.sender on a calldata condition — broadcast the solution and you WILL be front-run; submit privately), owner_only_payout, claimable, indeterminate or unfunded. Each entry ships payout-path evidence, front-run verdict and ETH at stake. Filters: ?classification=&funded_only=1&limit=.

## Output

A JSON object with a 'totals' summary, an 'entries' array of annotated contracts each carrying classification (locked_no_payout, frontrun_bait, owner_only_payout, claimable, indeterminate, unfunded), payout-path evidence, front-run verdict, ETH value at stake, and an 'as_of_ms' Unix timestamp indicating data freshness.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "totals": {
   "funded": 9,
   "watched": 24,
   "eth_at_frontrun_risk": 0.5,
   "eth_locked_no_payout": 1
  },
  "entries": [
   {
    "notes": [
     "Pays the caller on a calldata condition — submit privately."
    ],
    "address": "0xd7c6…",
    "balance_eth": 0.5,
    "payout_kinds": [
     "selfdestruct"
    ],
    "classification": "frontrun_bait",
    "frontrun_exposed": true
   }
  ],
  "as_of_ms": 1765532000000
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/seneschal-puzzle-bounty-contract-risk-feed-839ca79f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.seneschal.space](https://www.zero.xyz/host/api.seneschal.space/llms.txt)