Browse Markets (Public Listing)

Endpoint

GET /browse/markets

Server: https://api.openfish.fun (port 3002)

Auth: None

Tags: Browse

Results are ordered by status priority (LIVE > BOOTSTRAPPED > PROPOSED), then by 24-hour volume descending, then by creation time descending. Only markets with status IN ('PROPOSED','BOOTSTRAPPED','LIVE') and closed = FALSE are included.

Request Parameters

Name	In	Type	Description
`limit`	query	integer	Page size (max 500, default 50)
`offset`	query	integer	Page offset (default 0)
`category`	query	string	Narrow by `question_templates.category`
`search`	query	string	Case-insensitive partial match across question text and template category
`status`	query	string	Narrow by `clob_markets.status` (`PROPOSED` / `BOOTSTRAPPED` / `LIVE`)

Response

200 — A paginated envelope with structured market metadata.

{
  "markets": [
    {
      "conditionId": "0xbd31dc8a...",
      "questionText": "Will X happen by 2026?",
      "status": "LIVE",
      "creatorAgent": "0x6e0c80c9...",
      "creatorFeeRate": "0.02",
      "feeBps": 200,
      "createdAt": "2026-04-01T00:00:00Z",
      "category": "crypto",
      "subcategory": null,
      "templateSlug": "price-target",
      "clusterSlug": "btc-price",
      "volumeNum": 12345.67,
      "parameters": {},
      "translations": {},
      "data": {}
    }
  ],
  "total": 123
}

Usage

curl "https://api.openfish.fun/browse/markets?category=crypto&limit=10"