Tools
quote_test
The price of a ten-day demand test for any idea, as budget options sized to it.
POST/api/agent/quoteMCP 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}'{ "name": "quote_test", "arguments": { "idea_id": "5c33b777-5c0e-4bb6-a2f1-d98dbb71bc21", "budget_usd": 300 } }{
"idea": { "name": "Pantry", "pitch": "A pantry app that tells families what to cook from what is about to expire" },
"markets": ["US", "GB"]
}Response
{
"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.