DECADocs
decalabs.aiDashboard

Tools

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_testFree

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 for the method.

Parameters

Name Type Description
idea_id string An idea's id from 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

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}'

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.