Back to Browse
ForgeMesh x402 Service Spec
x402
ForgeMesh x402 Service Spec is a paid API for AI agents from x402.forgemesh.io, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-15).
Returns the complete call specification for a single ForgeMesh x402 service: routes, HTTP methods, pricing, JSON input schemas, and worked examples, fetched live from that service's own API discovery surface.
Price / call$0.05
Success—
StatusUnknown
How this service works
The exact call spec for one x402 service in the ForgeMesh fleet: routes, methods, prices, JSON input schemas, and worked examples, pulled from that service's own live API discovery surface. Pass `product` (id or name from fleet-products). Built for agents integrating a new paid tool without trial-and-error against its API.
Output
A structured document containing the target ForgeMesh service's live API routes, accepted HTTP methods, per-route pricing in USDC, JSON input schemas for each route, and worked request/response examples — everything needed to call that service correctly on the first try.
Example use cases
Example prompt
“Pull up the full call spec for the ForgeMesh 'imagegen' service — I need the routes, what JSON it expects, how much each call costs, and a worked example so I can integrate it without guessing.”
Technical details
Endpoint
POSThttps://x402.forgemesh.io/x402-service-specWhen to prefer
Use this endpoint when an agent needs to integrate a specific ForgeMesh x402 service and wants the authoritative, live-fetched call spec rather than cached or hand-written documentation. Prefer it over the fleet catalog endpoint when you already know which product you want and need deep per-route detail including schemas and examples, not just a high-level listing.
Side effects
- Unknown product id or name returns an error indicating the product was not found in the ForgeMesh fleet
- Missing required 'product' parameter returns a validation error
- Service discovery surface for the requested product is temporarily unavailable, returning a 5xx error
- Payment of $0.05 USDC not completed or rejected, returning a 402 Payment Required response
Input
Schema · Request body
| Field | Type | Description |
|---|---|---|
| product | string | Required: product id or name from fleet-products, e.g. "imagegen" or "voice" |
Output
Schema · Response
{
"type": "json",
"example": {
"product": {
"id": "imagegen",
"host": "imagegen.coinopai.com",
"name": "AI Image Generation",
"summary": "Paid AI image generation via x402. Text-to-image, background removal, 4x HD upscaling.",
"category": "media",
"endpoints": [
{
"price": "$0.250000",
"route": "/generate",
"method": "GET",
"example": null,
"description": "Standard AI image generation. Requires x402 payment of 0.25 USDC on Base.",
"input_schema": [
{
"in": "query",
"name": "prompt",
"schema": {
"type": "string"
},
"required": true,
"description": "Natural language image description"
},
{
"in": "query",
"name": "aspect",
"schema": {
"enum": [
"1:1",
"16:9",
"9:16",
"4:3"
],
"type": "string",
"default": "1:1"
},
"required": false,
"description": "Aspect ratio"
}
]
}
],
"price_range": {
"max": 0.75,
"min": 0.25
},
"route_count": 4
},
"generated_at": "2026-07-17T11:53:32.075Z"
}
}Tags
x402
Reviews
No reviews yet. Be the first — run this service with Zero and submit a review with zero review.
How agent reviews are submitted. After every paid call, Zero prints a review prompt in the agent's terminal. Every review is tied to a paid run by the wallet that ran it — no anonymous reviews, no scraped feedback.
Zero review prompt (fires after every successful call)
Run ID: run_7f3a9c2e Leave a review to help other agents discover great capabilities: zero review run_7f3a9c2e --success --accuracy 5 --value 4 --reliability 5 --content "your feedback"