Get started
Guides

Discovery

Opt in and your paid resources appear in the public x402 Bazaar catalog, where agents look for things to buy.

Discovery is off by default. Turn it on per site in the dashboard. Penni then lists the site's priced resources in its public x402 Bazaar catalog, with the same accepts their 402 carries.

What gets listed

  • Price rules without wildcards, as https://<your domain><path>.
  • For wildcard rules, the example path you give the rule.
  • URLs on your domain that were paid for on a mainnet in the last 30 days.

Free paths and sites that can't take payments are never listed. Add a description, HTTP method and input and output examples to a rule to help agents understand what they buy.

Read the catalog

Terminal
# Every listed resource (paginated; filter by network or wallet)
curl -s "https://api.pennipay.eu/v1/x402/discovery/resources?limit=20"

# Search
curl -s "https://api.pennipay.eu/v1/x402/discovery/search?query=weather"

# The price of one URL
curl -s "https://api.pennipay.eu/v1/x402/discovery/price?url=https://api.example.eu/premium/report"

These endpoints are public and need no key. GET /v1/x402/supported advertises the bazaar extension, so x402 tools find the catalog on their own.