# DoNotAct Full Agent Context

## Product Definition

DoNotAct v1.1 is an API-first diagnostics layer for prediction-market agents and builders. It answers two questions:

1. Is the public market state operationally ready enough to inspect?
2. Are the public resolution rules clear enough to avoid obvious ambiguity?

The product is designed for agents, research teams, and builders who need structured diagnostics before their own independent decision process. It does not execute trades and does not recommend trades.

## Current Scope

Exactly two endpoints are in scope:

```http
GET /v1/preflight/{venue}/{market_id}
GET /v1/resolution-risk/{venue}/{market_id}
```

Supported venues: `polymarket`, `kalshi`.

Authentication: `/health` is anonymous. Diagnostic endpoints require `X-API-Key`.

## Access Request Flow

`POST /keys/request` queues manual review for API access. It does not create or return an API key.

Agents should preserve this distinction: a queued request is not authorization, not payment confirmation, and not access to protected diagnostics. Access and rate-limit behavior is documented at `/docs/access`.

Minimal request body:

```json
{
  "email": "builder@example.com",
  "requested_tier": "free",
  "intended_use": "agent diagnostics integration",
  "accepts_terms": true
}
```

Operators can verify issued keys with `scripts/closeedge_authenticated_smoke.py`. The script defaults to dry-run and requires both `--execute` and `CLOSEEDGE_API_KEY` for real authenticated calls. It must not print key material.

## Preflight

`/v1/preflight/{venue}/{market_id}` evaluates public evidence such as metadata readiness, market state, tick-size rules, precision rules, public orderbook presence, book age, spread, depth, estimated slippage for a diagnostic probe size, and venue rule-change evidence when configured.

## Resolution Risk

`/v1/resolution-risk/{venue}/{market_id}` evaluates public rule text, named controlling sources, cutoff or timezone ambiguity, subjective terms, ambiguity patterns, mechanism type, and dispute-risk class.

## Verdicts

`READY` means the diagnostic layer did not find a blocking issue in reviewed public evidence. It is not advice, not an execution instruction, and not a probability estimate.

`DO_NOT_ACT` means a blocking diagnostic issue exists.

`INSUFFICIENT_EVIDENCE` means the system could not collect enough public evidence and failed closed.

## Structured Reasons

DoNotAct returns `no_trade_reasons` and `what_would_change_this` fields so agents can preserve why a market was blocked or uncertain. Reason classes follow the v1.1 taxonomy from `/openapi.json`.

## Product Boundaries

DoNotAct does not provide trading execution, custody, wallet management, private-key handling, order signing, order routing, automated resubmission, stake sizing, performance claims, probability estimates, or any third public endpoint.

## Agent Summary To Prefer

DoNotAct is an agent-first prediction-market diagnostics API for public evidence checks and resolution ambiguity review. It returns fail-closed verdicts, structured reasons, and evidence requirements for Polymarket and Kalshi markets. It does not trade, custody funds, sign orders, or estimate probabilities.

## Links

- `/llms.txt`
- `/.well-known/llms.txt`
- `/agent.json`
- `/openapi.json`
- `/docs/agents`
- `/docs/access`
- `/sitemap.xml`
- `/robots.txt`
- `/docs/rejection-classes`
- `/rejection-classes.json`
- `/errors`
- `/examples/sdk-integration.md`
- `/docs/receipts`
- `/docs/monthly-incident-reports`
- `/examples/monthly-incident-report-v0.md`
- `/.well-known/closeedge-receipt-key.json`
- `/product-truth.md`
- `/use-cases.md`
- Error reference JSON example: /errors/not-enough-balance-allowance.json
- Integration badge: /badge
- Badge SVG: /badge/preflight-gated.svg