> ## Documentation Index
> Fetch the complete documentation index at: https://docs.madra.finance/llms.txt
> Use this file to discover all available pages before exploring further.

# GET /discovery/resources

> Structured filter across the Bazaar catalog. Use for listing and faceted queries.

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

## Request

```http theme={null}
GET /discovery/resources?network=stellar:pubnet&type=mcp&maxPrice=0.01&limit=20 HTTP/1.1
```

All filters are documented in [Discovery Filters](/discovery/filters).

## Response

```json theme={null}
{
  "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.