Full-Text Search

Endpoint

GET /public-search

Server: https://gamma.openfish.fun

Tags: Search

Markets are matched against their question field, events against their title. Market results are wrapped in event-like envelopes for compatibility with the SDK’s expected response shape.

Request Parameters

Name	In	Type	Default	Description
`q`	query	string	`""`	Search query string (case-insensitive partial matching)
`limit_per_type`	query	integer	10	Maximum results per entity type (upper bound: 100)
`page`	query	integer	1	Page number for paginated results
`sort`	query	string	`volume`	Ordering field. Accepted values: `volume`, `liquidity`, `start_date`, `end_date`, `created_at`
`events_status`	query	string		Restrict event results by status: `active` or `closed`
`search_tags`	query	boolean	true	Whether to include matching tags
`search_profiles`	query	boolean	true	Whether to include matching user profiles

Response

200 — An object containing matched markets (wrapped as events), direct event matches, tags, profiles, and pagination metadata.

{
  "events": [
    {
      "id": "12345",
      "title": "Will BTC exceed $100k?",
      "slug": "will-btc-exceed-100k",
      "markets": [
        { "id": "12345", "question": "Will BTC exceed $100k?", ... }
      ]
    }
  ],
  "eventResults": [
    {
      "id": "456",
      "title": "Bitcoin price milestones",
      "slug": "bitcoin-price-milestones"
    }
  ],
  "tags": [
    { "id": "1", "label": "Crypto", "slug": "crypto" }
  ],
  "profiles": [
    { "address": "0xabc...", "name": "trader1" }
  ],
  "pagination": {
    "page": 1,
    "limit": 10,
    "hasMore": true
  }
}

Usage

curl "https://gamma.openfish.fun/public-search?q=bitcoin&limit_per_type=5"