DECADocs
decalabs.aiDashboard

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

  1. Ask. POST /api/agent/score with no payment answers 402 Payment Required: one USDC on Base, to DECA's wallet.
  2. Pay and send. Your x402 client signs the payment and sends the same request again with it in the PAYMENT-SIGNATURE header, with the idea in the body.
  3. Read. The answer is 200 with 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."
  }
}

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.