# Listing Roast x402

Listing Roast x402 is a paid HTTP JSON API for builders who need a quick read on why buyer agents skip a paid API or x402 marketplace listing.

## Free Discovery

- Homepage: https://listing-roast-x402-service-production.up.railway.app/
- Docs: https://listing-roast-x402-service-production.up.railway.app/docs
- API docs: https://listing-roast-x402-service-production.up.railway.app/api-docs
- AGENTS.md: https://listing-roast-x402-service-production.up.railway.app/AGENTS.md
- OpenAPI: https://listing-roast-x402-service-production.up.railway.app/.well-known/openapi.json
- OpenAPI aliases: https://listing-roast-x402-service-production.up.railway.app/openapi.json, https://listing-roast-x402-service-production.up.railway.app/api/v1/openapi.json, https://listing-roast-x402-service-production.up.railway.app/swagger.json
- x402 manifest: https://listing-roast-x402-service-production.up.railway.app/x402.json
- API catalog: https://listing-roast-x402-service-production.up.railway.app/.well-known/api-catalog
- Agent card: https://listing-roast-x402-service-production.up.railway.app/.well-known/agent-card.json
- Agent Skills index: https://listing-roast-x402-service-production.up.railway.app/.well-known/agent-skills/index.json
- MCP metadata: https://listing-roast-x402-service-production.up.railway.app/.well-known/mcp.json
- MCP discovery alias: https://listing-roast-x402-service-production.up.railway.app/.well-known/mcp
- MCP server-card metadata: https://listing-roast-x402-service-production.up.railway.app/.well-known/mcp/server-card.json
- Examples and commands: https://listing-roast-x402-service-production.up.railway.app/api/examples
- Pay-now handoff: https://listing-roast-x402-service-production.up.railway.app/api/pay-now?intent=buyer-agent%20skip%20reasons
- Pricing catalog: https://listing-roast-x402-service-production.up.railway.app/api/pricing
- Route finder: https://listing-roast-x402-service-production.up.railway.app/api/find?q=x402%20discovery%20audit
- Cash register: https://listing-roast-x402-service-production.up.railway.app/api/cash-register

## Payment Rule

Do not call paid routes unless the buyer explicitly intends to pay USDC through x402. All free discovery routes above are safe to fetch without payment.

## Preferred First Paid Route

- Method: GET
- URL: https://listing-roast-x402-service-production.up.railway.app/api/listing-roast
- Price: $0.001
- Max amount: 1000 USDC units
- Best for: paid API listing quality, marketplace listing quality, x402 listing quality, agent service listing clarity, and buyer-agent skip reasons.

```bash
npx awal@2.8.0 x402 pay https://listing-roast-x402-service-production.up.railway.app/api/listing-roast \
  -X GET \
  --max-amount 1000
```

## Recommended Paid Sequence

1. Start with GET https://listing-roast-x402-service-production.up.railway.app/api/listing-roast for $0.001, max 1000 USDC units. This is the already-indexed quick score route and the lowest-friction paid test.
2. Upgrade to POST https://listing-roast-x402-service-production.up.railway.app/api/listing-roast for $0.01, max 10000 USDC units only when the quick score is promising and the buyer wants the full rewrite, top fixes, and stop-or-upgrade guidance.

Full roast command:

```bash
npx awal@2.8.0 x402 pay https://listing-roast-x402-service-production.up.railway.app/api/listing-roast \
  -X POST \
  -d '{"agentName":"Example x402 API","listingText":"A paid x402 API that helps builders check whether buyer agents understand the offer before paying. It returns JSON with skip reasons, top fixes, a rewritten listing, and a stop-or-upgrade recommendation. Example payloads are included for quick testing.","targetBuyer":"x402 and MCP builders","currentPrice":"$1.00","currentCheckoutPath":"/api/listing-roast","goal":"Increase first paid conversion"}' \
  --max-amount 10000
```

## Other Paid Routes

- GET https://listing-roast-x402-service-production.up.railway.app/api for a generic paid x402 navigation route map with fallback quick score when an agent starts at /api first. Price: $0.001. Max amount: 1000.
- GET https://listing-roast-x402-service-production.up.railway.app/api/v1 for a versioned paid x402 navigation route map with fallback quick score when an agent starts at /api/v1 first. Price: $0.001. Max amount: 1000.
- GET https://listing-roast-x402-service-production.up.railway.app/v1 for a short versioned paid x402 navigation route map with fallback quick score when an agent starts at /v1 first. Price: $0.001. Max amount: 1000.
- GET https://listing-roast-x402-service-production.up.railway.app/api/agent-listing-conversion for agent listing conversion score and buyer-agent skip reasons. Price: $0.001. Max amount: 1000.
- GET https://listing-roast-x402-service-production.up.railway.app/api/x402-marketplace-conversion for x402 marketplace conversion score. Price: $0.001. Max amount: 1000.
- GET https://listing-roast-x402-service-production.up.railway.app/api/x402-site-audit for x402 route health, direct 402 metadata, stale price checks, and search visibility. Price: $0.001. Max amount: 1000.
- POST https://listing-roast-x402-service-production.up.railway.app/api/listing-score for a custom-body listing score. Price: $0.005. Max amount: 5000.
- POST https://listing-roast-x402-service-production.up.railway.app/api/x402-discovery-audit for a custom-body x402 discovery audit. Price: $0.01. Max amount: 10000.
- POST https://listing-roast-x402-service-production.up.railway.app/api/listing-roast for the full listing roast, rewrite, top fixes, and stop-or-upgrade guidance. Price: $0.01. Max amount: 10000.

## Keywords

marketplace listing score, marketplace listing quality, marketplace listing conversion, paid API listing quality score, agent-service listing score, x402 marketplace conversion, x402 site audit, x402 service discoverability audit, x402 route health check, x402 navigation, API entrypoint, route map, paid API preflight, x402 discovery audit, x402 bazaar discovery audit, x402 listing stale price, buyer-agent skip reasons, buyer agent skip reasons, agent service listing clarity, agent service listing audit, agent listing conversion score, agent listing conversion, agent listing clarity, x402 listing quality, paid API listing, x402 listing, x402 service discoverability