# IdeaRoast

> Automated startup idea due diligence. Free quick roast or $2 for the full 4-agent panel with live market data. No account required. Structured JSON output designed for agent consumption.

IdeaRoast runs a panel of specialist AI agents — Market, Tech, Finance, Timing — that independently analyze a startup idea and brief a Verdict Agent. The result includes a survival tier (Ship It / Decent / Needs Work / Roasted), a one-line kill-shot verdict, typed red flags, and a pivot recommendation.

## Discovery

Machine-readable agent manifest:
```
GET https://www.idearoast.dev/.well-known/agent.json
```

Self-describing API schema (no payment required):
```
GET https://www.idearoast.dev/api/agent
```

## Free Endpoint (no payment)

Quick single-voice roast. Rate limited to 1 per IP per day.

```
GET https://www.idearoast.dev/api/roast/free?idea=<url-encoded idea>
```

Optional parameters: `stage`, `market`, `traction`

Returns HTTP 200:
```json
{
  "tier": "roasted",
  "verdict": "One brutal sentence.",
  "survival_rating": 2,
  "red_flags": ["specific problem", "specific problem", "specific problem"],
  "upgrade": {
    "message": "Get the full 4-agent panel with live market data for $2.",
    "url": "https://www.idearoast.dev/roast",
    "agent_endpoint": "https://www.idearoast.dev/api/agent"
  }
}
```

Returns HTTP 429 if rate limit exceeded:
```json
{
  "error": "rate_limit_exceeded",
  "message": "Free tier allows 1 roast per day. Upgrade to the full panel for $2."
}
```

## Paid Endpoint — Full 4-Agent Panel ($2 BTC)

### Step 1: Request a roast

```
GET https://www.idearoast.dev/api/agent?idea=<url-encoded idea>
```

Optional parameters: `stage`, `market`, `traction`

Returns HTTP 402:
```json
{
  "error": "payment_required",
  "roast_id": "uuid",
  "payment": {
    "address": "bc1q...",
    "amount_sats": 4800,
    "amount_btc": "0.00004800",
    "amount_usd": "2.00",
    "currency": "BTC",
    "network": "bitcoin"
  },
  "next": "Poll GET /api/agent?roast_id=<uuid> after payment confirms."
}
```

### Step 2: Send payment

Send the exact BTC amount to the returned address. Each address is unique per roast — do not reuse.

### Step 3: Poll for result

```
GET https://www.idearoast.dev/api/agent?roast_id=<uuid>
```

Status progression: `awaiting_payment` (HTTP 402) → `pending` (HTTP 202) → `complete` (HTTP 200) / `failed` (HTTP 500)

Returns HTTP 200 when complete:
```json
{
  "status": "complete",
  "roast_id": "uuid",
  "structured": {
    "verdict": "One brutal quotable sentence.",
    "survival_rating": 3,
    "survival_reason": "One sentence justifying the score.",
    "red_flags": [
      { "name": "Problem name", "detail": "Specific explanation." },
      { "name": "Problem name", "detail": "Specific explanation." },
      { "name": "Problem name", "detail": "Specific explanation." }
    ],
    "blind_spot": "The one thing they haven't mentioned that will actually kill them.",
    "pivot": "One actionable save recommendation.",
    "panel": [
      { "agent": "Market Agent",  "emoji": "🔍", "finding": "...", "live": true },
      { "agent": "Tech Agent",    "emoji": "⚙️", "finding": "..." },
      { "agent": "Finance Agent", "emoji": "💰", "finding": "..." },
      { "agent": "Timing Agent",  "emoji": "⏱️", "finding": "..." }
    ]
  },
  "roast_markdown": "## ☠️ The Verdict\n...",
  "share_url": "https://www.idearoast.dev/r/uuid"
}
```

## Survival Tiers

| Tier | Rating | Meaning |
|---|---|---|
| SHIP IT | 8–10 | Ready to build |
| DECENT | 6–7 | Needs refinement |
| NEEDS WORK | 4–5 | Significant issues |
| ROASTED | 1–3 | Don't build this |

## How agents pay autonomously

Agents need a funded Bitcoin wallet. The recommended pattern is a payment relay — a lightweight server your agent calls as a tool:

```
Agent → GET /api/agent?idea=...    → 402 + BTC address + roast_id
Agent → POST relay/pay/btc         → broadcasts transaction
Agent → GET /api/agent?roast_id=.. → polls until complete
```

The relay holds a pre-funded wallet. Fund it with ~$20 BTC. Each roast costs ~$2 including network fees.

## Payment notes

- Each BTC address is unique per roast — do not reuse addresses
- Payment is detected on mempool entry (~30s), roast generates immediately
- Confirmed after 1 block (~10 min)
- Results are permanent at idearoast.dev/r/<roast_id>

## Web UI

Human-facing interface: https://www.idearoast.dev/roast
Free tier available — no payment, no account. 1 roast per day.
Full panel: pay with USDT (Ethereum) or Bitcoin.