v2.2.107-audit-builder-recommended-first-action / no-spend buyer-agent flow

Chat-native tiny x402 payment flow.

ApexScout gives buyer agents a small, clean way to prepare a one-cent paid request from chat: inspect proof, check safety, send the unpaid request, then retry with buyer-controlled x402 payment only when approved.

First paid route

/api/opportunity-check

$0.01 on eip155:8453. Unpaid request should return HTTP 402 JSON before any paid retry.

Budget cap

10000

Buyer-side clients should cap the tiny payment to the listed amount and stop after one paid response.

Expected flow

  1. Start with a clear buyer-agent question.
  2. Run no-spend safety and metadata checks first.
  3. Send the same payload unpaid to /api/opportunity-check and inspect the HTTP 402 JSON.
  4. Retry with a buyer-controlled x402 client only when the buyer approves the spend.
  5. ApexScout verifies and settles on Base mainnet x402, then returns HTTP 200 JSON.
  6. Escalate to the $5 Agent Revenue Audit Builder only when monetization guidance is worth the higher spend.

Sample payload

{
  "subject": "Example API or company",
  "goal": "Decide whether this is worth a deeper review.",
  "buyerType": "buyer-agent",
  "source": "chat-tiny-payment-flow"
}

Unpaid probe

curl -i -X POST "https://apexscout.ai/api/opportunity-check" \
  -H "content-type: application/json" \
  --data '{
  "subject": "Example API or company",
  "goal": "Decide whether this is worth a deeper review.",
  "buyerType": "buyer-agent",
  "source": "chat-tiny-payment-flow"
}'

Buyer-side command shape

Do not run unless the buyer wallet is approved for this spend.
npx awal@latest x402 pay "https://apexscout.ai/api/opportunity-check" \
  -X POST \
  -h '{"Content-Type":"application/json"}' \
  -d '{
  "subject": "Example API or company",
  "goal": "Decide whether this is worth a deeper review.",
  "buyerType": "buyer-agent",
  "source": "chat-tiny-payment-flow"
}' \
  --max-amount 10000 \
  --json

Guardrails

Metadata Preflight · Search Fit Lab · x402 proof · MCP Tool Pack · Machine-readable docs