Buyer Agent Quickstart

Hit 402. Pay. Retry for 200.

The shortest safe path for a buyer agent: inspect the $0.01 route, hit the expected HTTP 402, pay with its own x402 client, and retry for HTTP 200.

$0.01 first route Base mainnet x402 402 is expected

Start here

/api/opportunity-check

Use this when you are unsure whether a target or claim deserves more paid work.

Payment boundary

No auto-spend

This page does not execute payment. Buyer agents pay only with their own wallet and x402 client.

Fastest path

  1. Read /docs.json or this quickstart first.
  2. Send the recommended POST route without payment and expect HTTP 402.
  3. Treat HTTP 402 as the x402 payment challenge, not a service failure.
  4. Pay the listed route price with a buyer-controlled x402 client on Base mainnet.
  5. Retry the exact same POST and expect HTTP 200 with structured JSON.

Expected unpaid challenge

402 means the paywall is working.

HTTP 402 means the x402 paywall is working. It is not a service outage.

curl -i -X POST "https://apexscout.ai/api/opportunity-check" \
  -H "content-type: application/json" \
  --data '{
  "subject": "Agent trust scoring for crypto vendors",
  "buyer": "Crypto fund operator",
  "marketType": "vendor",
  "geography": "United States",
  "goal": "Decide whether this topic is strong enough to package into a deeper diligence offer.",
  "knownSignals": [
    "Operators keep asking for a faster first-pass trust screen before pilots",
    "Funds want a lightweight way to compare agent vendors before deeper diligence"
  ],
  "constraints": [
    "Keep the first offer lightweight",
    "Do not assume the buyer already trusts agent vendors"
  ]
}'

Copy-paste payload

{
  "subject": "Agent trust scoring for crypto vendors",
  "buyer": "Crypto fund operator",
  "marketType": "vendor",
  "geography": "United States",
  "goal": "Decide whether this topic is strong enough to package into a deeper diligence offer.",
  "knownSignals": [
    "Operators keep asking for a faster first-pass trust screen before pilots",
    "Funds want a lightweight way to compare agent vendors before deeper diligence"
  ],
  "constraints": [
    "Keep the first offer lightweight",
    "Do not assume the buyer already trusts agent vendors"
  ]
}

Paid retry expectation

Status

Retry the same POST after payment and expect HTTP 200.

Network

eip155:8453

Facilitator

https://api.cdp.coinbase.com/platform/v2/x402

Seller wallet

Visible only in x402 payment requirements and internal operator records.

Buyer links

Docs JSONRoute schemas and prices. Examplescurl, TypeScript, and Python examples. First paid call wizardChoose the smallest useful route. Instant x402Pick a route and inspect the 402 flow.

Guardrails