List markets

Open events, busiest first. Filter by category, league or a search word. Each event carries its top three markets; fetch the event for all of them.

GEThttps://backd.market/api/v1/marketscached 30 seconds

Request

curl "https://backd.market/api/v1/markets?category=Football&league=epl&q=arsenal&limit=10"

Parameters

Name	In	Type	Description
`category`	query	string	One of Football, Sport, Crypto, Politics, Geopolitics, Economy, Tech, Culture. Leave out for trending. Example: `Football`
`league`	query	string	A league or coin key from the response’s `leagues` list, e.g. epl, ucl, nfl, bitcoin. Overrides category. Example: `epl`
`q`	query	string	Search the event title and market questions (case-insensitive, up to 80 characters). Example: `arsenal`
`limit`	query	integer	How many events, 1 to 60. Default 24. Example: `10`

Response

200 OK

{
  "ok": true,
  "live": true,
  "count": 2,
  "categories": ["Sport", "Football", "Crypto", "Politics", "Geopolitics", "Economy", "Tech", "Culture"],
  "leagues": [{ "group": "Football", "label": "Premier League", "league": "epl" }, "…"],
  "events": [ { "slug": "…", "title": "…", "category": "Football", "markets": [ "…up to 3…" ], "market_count": 12, "url": "…" } ]
}

Fields

Field	Type	Meaning
`live`	boolean	False when Polymarket could not be reached and sample markets are being shown. Don’t record anything from a non-live response.
`events[]`	Event	See “Get an event” for the full shape. Lists carry at most three markets per event.