X402 Discover
Discover machine-payable x402 services for a task by searching Bazaar resource metadata and returning normalized candidate endpoints, capabilities and payment-discovery facts. This is service/resource discovery only; it does not invoke or pay the discovered endpoint.
Forest exposes this capability as a deterministic machine-readable API for software agents. Discovery is free; execution uses the canonical paid endpoint below. The live x402 challenge is the source of truth for payment terms.
$0.002 / callPOST /x402/discoverx402 · Base
Typical agent tasks
This capability is intended for bounded machine decisions such as:
- discover an x402 service that can handle a requested task
- search the Bazaar catalog for machine-payable API resources
- find candidate x402 endpoints by capability or buyer intent
- locate paid agent services without invoking or purchasing them
What Forest guarantees
- bounded normalized public-source lookup
Boundaries
- provider-specific guarantees
- unpublished facts
Machine contract
The request and response schemas are published in the canonical OpenAPI document. This page shows a representative input from the same production manifest.
Input example
{
"query": "weather"
}
Canonical paid endpoint
https://http--forest-gas-station-mainnet--lcjl27p8lmjs.code.run/x402/discover
Related capabilities
- X402 Preflight — Inspect whether a public HTTP endpoint requires x402 payment and normalize the advertised PaymentRequired terms before a buyer decides to call it. Reports payment requirement metadata only; it never signs, pays or executes the protected operation.