v2

latestOpenAPI 3.0.1MIT2026-07-31803580.5 KB
x402-discovery
buyer-conversion
provider-diagnostic

Find why agents are not buying an x402 endpoint

Run one free read-only provider diagnostic across payment readiness, exact CDP Bazaar activation, five buyer-task retrieval samples, a submitted buyer budget and network policy, and public demand fields. Returns the earliest observable blocker and withholds paid recommendations when the sample does not justify work. It never signs or settles a payment.

post/api/tools/agent-buyer-conversion-diagnostic

Request body

agent_policy'strict' | 'standard' | 'permissive'
allowed_networkstring

Optional CAIP-2 network such as eip155:8453.

buyer_querystring required

One public task phrase a funded agent should use to find the endpoint.

endpoint_urlstring uri required

Public x402 paid endpoint. Query strings are removed from output.

max_budget_usdcstring

Optional non-negative simulated buyer budget.

publish_reportboolean

Explicitly publish a public Buyer Path Receipt and badge. The receipt exposes the public endpoint and buyer-task phrases but omits the simulated budget, raw evidence, credentials, and wallet data.

remote_urlstring uri
repository_urlstring uri
server_json_urlstring uri
server_namestring

Response

Earliest observable purchase blocker and evidence stages