---
title: "Find why agents are not buying an x402 endpoint"
method: POST
path: "/api/tools/agent-buyer-conversion-diagnostic"
tags: ["x402-discovery", "buyer-conversion", "provider-diagnostic"]
---

# Find why agents are not buying an x402 endpoint

`POST /api/tools/agent-buyer-conversion-diagnostic`

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.

## Request body

- object
  - `agent_policy` 'strict' | 'standard' | 'permissive'
  - `allowed_network` string — Optional CAIP-2 network such as eip155:8453.
  - `buyer_query` string, required — One public task phrase a funded agent should use to find the endpoint.
  - `endpoint_url` string, uri, required — Public x402 paid endpoint. Query strings are removed from output.
  - `max_budget_usdc` string — Optional non-negative simulated buyer budget.
  - `publish_report` boolean — 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_url` string, uri
  - `repository_url` string, uri
  - `server_json_url` string, uri
  - `server_name` string

## Response `200`

Earliest observable purchase blocker and evidence stages

## Other responses

- `400` — Invalid public endpoint, buyer phrase, or budget
- `429` — Per-client free diagnostic limit reached

---

[API](https://skmtc.net/ontarioprotocol/apis/ontario-protocol-x402-api.md) · [All operations](https://skmtc.net/ontarioprotocol/apis/ontario-protocol-x402-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ontarioprotocol/ontario-protocol-x402-api/revisions/54384a1c4bf3/schema)