# Listing Roast x402

Listing Roast x402 is a paid API for x402, MCP, and agent-service builders who need a marketplace listing score, paid API listing quality check, marketplace listing conversion feedback, or x402 service discoverability guidance before promotion.

Homepage: https://listing-roast-x402-service-production.up.railway.app/
Command builder: https://listing-roast-x402-service-production.up.railway.app/builder
Sample score page: https://listing-roast-x402-service-production.up.railway.app/sample
Sample score JSON: https://listing-roast-x402-service-production.up.railway.app/api/sample-score
OpenAPI: https://listing-roast-x402-service-production.up.railway.app/openapi.json
x402 manifest: https://listing-roast-x402-service-production.up.railway.app/x402.json
MCP metadata: https://listing-roast-x402-service-production.up.railway.app/.well-known/mcp.json
Keywords: marketplace listing score, marketplace listing quality, marketplace listing conversion, paid API listing, x402 listing, x402 service discoverability

Paid routes:

- GET https://listing-roast-x402-service-production.up.railway.app/api/instant-listing-score
  - Price: $0.001
  - Network: eip155:8453
  - Max amount: 1000 USDC units
  - Output: instant score, checked signals, first fix, next step
  - Use when an agent wants to pay without first assembling a JSON body

- GET https://listing-roast-x402-service-production.up.railway.app/api/listing-roast
  - Price: $0.001
  - Network: eip155:8453
  - Max amount: 1000 USDC units
  - Output: quick score from the already-indexed listing-roast URL
  - Use when a marketplace result points to /api/listing-roast without method metadata

- GET https://listing-roast-x402-service-production.up.railway.app/api/x402-ping
  - Price: $0.001
  - Network: eip155:8453
  - Max amount: 1000 USDC units
  - Output: paid ping, timestamp, echo message, and next paid routes
  - Use when an agent wants to verify the x402 rail before buying a score or roast

- POST https://listing-roast-x402-service-production.up.railway.app/api/listing-score
  - Price: $0.005
  - Network: eip155:8453
  - Max amount: 5000 USDC units
  - Output: score, checked signals, first fix, next step, upgrade endpoint

- POST https://listing-roast-x402-service-production.up.railway.app/api/listing-roast
  - Price: $0.01
  - Network: eip155:8453
  - Max amount: 10000 USDC units
  - Output: buyer-agent skip reasons, top fixes, rewritten listing, stop-or-upgrade guidance

Request body JSON:

{
  "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"
}

Use the $0.001 instant GET score first when a buyer agent wants the fastest paid test without a JSON body.