# quote_test

> The price of a ten-day demand test for any idea, as budget options sized to it.

**POST /api/agent/quote · MCP tool quote_test · Free**
`quote_test` prices a demand test before anything is paid. A test costs **only its ad budget, at cost**, in USDC on Base. DECA adds no fee and no markup.

The budget is not one number. DECA sizes a few options to the idea from what it can be expected to do, and each option says what it can and cannot tell. See [How a test is priced](https://app.decalabs.ai/docs/guides/pricing) for the method.

## Parameters

| Name | Type | Description |
|---|---|---|
| `idea_id` | string | An idea's `id` from [`get_ideas`](https://app.decalabs.ai/docs/tools/get-ideas). Use this or `idea`. |
| `idea.pitch` | string | Your own idea: who it is for and what it does for them, 20 to 2,000 characters. It is never published. |
| `idea.name` | string | A name for your idea. Optional. |
| `markets` | array | Where the ads run: `US`, `GB`, `CA`. Default all three. |
| `budget_usd` | number | A budget of your own to price alongside the options, from 250 to 2,000. Optional. |

## Request

```bash title="cURL"
curl -X POST https://app.decalabs.ai/api/agent/quote \
  -H "content-type: application/json" \
  -d '{"idea_id": "5c33b777-5c0e-4bb6-a2f1-d98dbb71bc21", "budget_usd": 300}'
```

```json title="MCP"
{ "name": "quote_test", "arguments": { "idea_id": "5c33b777-5c0e-4bb6-a2f1-d98dbb71bc21", "budget_usd": 300 } }
```

```json title="Your own idea"
{
  "idea": { "name": "Pantry", "pitch": "A pantry app that tells families what to cook from what is about to expire" },
  "markets": ["US", "GB"]
}
```

## Response

```json
{
  "quote_id": "q1.eyJ2IjoxLCJpZGVhIjoiN…",
  "expires_at": "2026-11-18T20:24:28.715Z",
  "currency": "USDC",
  "network": "base",
  "fee_usd": 0,
  "idea": { "id": "5c33b777-5c0e-4bb6-a2f1-d98dbb71bc21", "name": "Drawerly" },
  "assumptions": { "signup_rate": 0.037, "cost_per_click_usd": 0.75, "confirm_share": 0.7, "source": "this idea's reading by our engine, with click costs measured in our own ad accounts in 2026" },
  "options": [
    {
      "id": "signal",
      "label": "Signal: is there demand at all",
      "budget_usd": 450,
      "markets": ["US", "GB", "CA"],
      "days": 10,
      "expected_visits": 600,
      "pass_line": 16,
      "first_part": { "usd": 150, "days": 3, "continue_if_at_least": 3 },
      "tells": "Whether at least 16 people in US, GB, CA confirm their email for this before it exists. The cheapest budget whose answer is more than noise.",
      "does_not_tell": "How strong the demand is, or which market wants it most; a near miss could go either way."
    },
    {
      "id": "clear",
      "label": "Clear read: a result that rests less on luck",
      "budget_usd": 900,
      "expected_visits": 1200,
      "pass_line": 31,
      "…": "…"
    }
  ],
  "recommended": "signal",
  "declined": [
    { "id": "yours", "why": "$300 buys about 400 visits; its line would be 10 confirmed people, below the 15 under which a pass is noise. The smallest budget that says something here is $450." }
  ],
  "review": { "required": true, "note": null },
  "refunds": "Declined at review or cancelled before going live: refunded in full. …",
  "next": "Pay an option with start_test. Try it first with sandbox: true, on Base Sepolia with test USDC; real tests pay in USDC on Base."
}
```

| Field | Description |
|---|---|
| `quote_id` | A signed id for this quote. Pass it to `start_test` to pay. |
| `expires_at` | The quote holds for 30 minutes. |
| `assumptions` | The sign-up rate and click cost the options rest on, and where they come from. |
| `options[].budget_usd` | What the option costs, all of it ad budget. |
| `options[].pass_line` | Confirmed sign-ups the test must reach to pass. Set before the first ad runs and never lowered. |
| `options[].pass_line_by_market` | For a market comparison: each market's own line. |
| `options[].first_part` | Budgets from $300 run a first part for three days. If it brings fewer than `continue_if_at_least` confirmed sign-ups, the test stops and the rest is refunded. |
| `options[].tells` · `does_not_tell` | What this budget can answer, and what it cannot. |
| `declined` | Options that were left out, and why: too costly to read reliably, or a budget of yours too small to say anything. |
| `review.note` | Set when the idea touches an area ad platforms restrict, such as finance, crypto, health or gambling. Such a test may be declined at review and refunded in full. |

The options are:

| `id` | When it is offered |
|---|---|
| `signal` | Always, unless no budget up to $2,000 can read the idea reliably. |
| `clear` | When twice the signal budget still fits under $2,000. |
| `compare` | When you ask for more than one market and every market's own line fits under $2,000 in total. |
| `yours` | When you send `budget_usd` and it can say something. |

> **Note** · Over MCP, a quote that cannot offer anything comes back as an error with `code: "no_reliable_option"` and the reasons in `details`.

Source: https://app.decalabs.ai/docs/tools/quote-test
