# Score an idea for 1 USDC

> 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](https://x402.org) 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.

```json title="Request body"
{
  "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."
  }
}
```

```json title="Answer (example)"
{
  "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](https://faucet.circle.com)). 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`](https://app.decalabs.ai/docs/tools/quote-test) and follow [Paid tests](https://app.decalabs.ai/docs/guides/paid-tests).

Source: https://app.decalabs.ai/docs/guides/score-idea
