GET /discovery/resources - StellarX402

Returns a paginated list of Bazaar listings matching structured filters. Use this when you have filters but no free-text query; use /discovery/search when you have a query.

Request

GET /discovery/resources?network=stellar:pubnet&type=mcp&maxPrice=0.01&limit=20 HTTP/1.1

All filters are documented in Discovery Filters.

Response

{
  "results": [
    {
      "id": "lst_01H...",
      "type": "http",
      "resource": "https://api.example.com/weather/{lat}/{lng}",
      "payment": {
        "scheme": "exact",
        "network": "stellar:pubnet",
        "asset": "USDC",
        "amount": "50000"
      },
      "describe": {
        "title": "Weather forecast",
        "description": "5-day hourly forecast",
        "tags": ["weather", "forecast"],
        "inputs": { "lat": "number", "lng": "number" }
      },
      "signals": {
        "lastSettled": "2026-08-08T09:11:03Z",
        "settleCount7d": 812,
        "rejectionRate7d": 0.021
      }
    }
  ],
  "nextCursor": "eyJvZmZzZXQiOjIwfQ=="
}

Pagination

Pass the previous response’s nextCursor as ?cursor= to fetch the next page.
nextCursor is absent on the last page.
Cursors are opaque; do not parse them.

Notes

Filter validation is strict. Unknown query params return 400 unknown_filter.
Zero results is 200 with an empty array, not 404.
Result freshness is eventually consistent; a listing can appear within a few seconds of the first 402 served for it.