Guides
Score an idea for 1 USDCNew
One call, one USDC on Base over x402, and your own idea comes back scored against live app-store demand.
The smallest thing an agent can buy from DECA: send an idea, pay one USDC, and get back a verdict with the reason, the closest apps already on the charts, the sign-ups a $500 ad test should bring, and the smallest budget that would give a real answer.
There is no quote step and no key. The price is fixed, and you are charged only when a score comes back.
:::endpoint POST /api/agent/score · REST only · 1 USDC
The flow
- Ask.
POST /api/agent/scorewith no payment answers402 Payment Required: one USDC on Base, to DECA's wallet. - Pay and send. Your x402 client signs the payment and sends the same request again with it in the
PAYMENT-SIGNATUREheader, with the idea in the body. - Read. The answer is
200with the score and the payment's transaction.
{
"idea": {
"name": "Petsitter",
"pitch": "An app for dog owners in big cities to find a vetted sitter for the same evening, with live photo updates during the visit."
}
}{
"score": {
"name": "Petsitter",
"summary": "A phone app that finds a vetted dog sitter for tonight and sends photos during the visit.",
"verdict": "maybe",
"reason": "It works if owners trust a sitter they have not met; the closest apps are rated down for no-shows.",
"expected_signups_at_500_usd": 21,
"signup_rate_to_pass_pct": 2.4,
"smallest_useful_budget_usd": 500,
"closest_apps": ["Rover", "Wag!"]
},
"paid": { "usd": 1, "network": "Base", "tx": "0x…" }
}pitch is 20 to 2,000 characters: who the product is for and what it does for them. name is optional. verdict is go, maybe or hold.
What you are not charged for
- A request with no payment, or with a body that is not an idea.
- An idea the engine could not score. The answer says so and the payment is not settled.
- The same payment sent twice. It returns the score it already bought.
Sandbox
Add ?sandbox=1 to run the same exchange on Base Sepolia for one test USDC (free from Circle's faucet). The sandbox answers with a fixed example and does not run the engine.
Then test it
A score is a forecast. To learn what real people do, pass the same pitch to quote_test and follow Paid tests.