Polymarket Search API (2026): Find Markets and Events by Keyword

How do you search Polymarket markets with the API?

Send a keyword to /public-search. This returns ten active events matching "bitcoin":

curl -s "https://gamma-api.polymarket.com/public-search?q=bitcoin&events_status=active&limit_per_type=10"

The response is an events array plus a pagination object. Each event is a full Gamma event, so it carries its markets, volume, dates and comment count. Fields are trimmed here:

{
  "events": [
    {
      "id": "1112205",
      "slug": "what-price-will-bitcoin-hit-in-october-2026",
      "title": "What price will Bitcoin hit in October?",
      "active": true,
      "closed": false,
      "volume24hr": 934720.119706,
      "markets": [
        {
          "question": "Will Bitcoin reach $150,000 in October?",
          "conditionId": "0x8717c39520cadcb8ad6f88af148c30acf7d044c92a9cf48416b9b9a5ed65d6d8",
          "outcomes": "[\"Yes\", \"No\"]",
          "outcomePrices": "[\"0.0055\", \"0.9945\"]",
          "closed": false
        }
      ]
    }
  ],
  "pagination": { "hasMore": true, "totalResults": 854 }
}

What parameters does Polymarket's search endpoint take?

Gamma's OpenAPI spec lists the parameters without descriptions, so the behavior below is what we observed on 3 October 2026, with sort values from the official SDK.

limit_per_type applies to each result type separately, so limit_per_type=8 with tags and profiles switched on returned eight events, eight profiles and every matching tag. optimized=true cut a five-event response from about 258 KB to 40 KB, but its markets carry no conditionId or clobTokenIds, and it moves hasMore to the top level.

How do you filter search results by tag and status?

Tags use two identifiers. events_tag wants the slug, and exclude_tag_id wants the numeric id. GET /tags/slug/crypto returns both, an id of "21" and a slug of crypto, and so does a search with search_tags=true.

Repeating events_tag narrows the results rather than widening them. In our checks, an active search for "trump" matched 372 results, 325 with events_tag=politics, 9 with events_tag=crypto, and 8 with both tags as separate parameters. Joining them with a comma, as events_tag=crypto,politics, matched nothing. Going the other way, exclude_tag_id=21 left six active "bitcoin" events outside the Crypto tag.

Status needs a second check. events_status=active cut "bitcoin" from 137,559 matches to 854, yet when we sorted that active search by end_date or liquidity, events with closed: true still came back. Filter on each event's closed flag, and on each market's, before you display or trade anything. To keep markets that closed recently, such as yesterday's daily markets, add keep_closed_markets=24 for a 24-hour window.

recurrence isolates repeating series. Among active "bitcoin" events it matched 9 daily, 26 weekly and 2 monthly events.

How do you build a market search in JavaScript?

This turns a keyword into a flat list of open markets with their Yes price and condition id. It runs on Node 18 or newer with no dependencies:

const GAMMA = 'https://gamma-api.polymarket.com';

async function searchMarkets(q, { tag, limit = 10, page = 1 } = {}) {
  const url = new URL('/public-search', GAMMA);
  url.searchParams.set('q', q);
  url.searchParams.set('events_status', 'active');
  url.searchParams.set('sort', 'volume_24hr');
  url.searchParams.set('limit_per_type', String(limit));
  url.searchParams.set('page', String(page));
  if (tag) url.searchParams.append('events_tag', tag);

  const res = await fetch(url);
  if (!res.ok) throw new Error(`public-search returned ${res.status}`);
  const { events = [], pagination } = await res.json();

  const markets = events
    .filter((event) => !event.closed)
    .flatMap((event) =>
      (event.markets ?? [])
        .filter((market) => !market.closed)
        .map((market) => ({
          event: event.title,
          question: market.question,
          yes: Number(JSON.parse(market.outcomePrices ?? '[]')[0]),
          conditionId: market.conditionId,
        })),
    );

  return { markets, hasMore: pagination?.hasMore ?? false };
}

const { markets, hasMore } = await searchMarkets('bitcoin', { tag: 'crypto' });
console.table(markets.slice(0, 10));
console.log({ hasMore });

For browsing a tag without a keyword, Gamma's listing endpoints are the better tool, covered in our Polymarket Gamma API guide. Search is for text.

How do you search with Polymarket's SDK?

The unified TypeScript SDK exposes the same filters in camel case, with the sort values as an enum:

import { createPublicClient, SearchSort } from '@polymarket/client';

const client = createPublicClient();

const pages = client.search({
  q: 'bitcoin',
  eventsStatus: 'active',
  eventsTag: ['crypto'],
  sort: SearchSort.Volume24Hr,
  ascending: false,
  pageSize: 10,
});

const { items } = await pages.firstPage();
for (const event of items.events) {
  console.log(event.id, event.slug, event.title);
}

Profile search is useful on its own. With search_profiles=true, each profile carries name, pseudonym and proxyWallet, and that wallet is what the Data API accepts for positions and activity, as shown in our Polymarket Data API guide.

How do you search every prediction market at once?

Gamma searches Polymarket. The same event often trades on Kalshi, Limitless and other venues, each with its own search syntax and response shape. The Predictefy API searches 15+ venues through its router in one request, and returns every match in one normalized market shape:

import Predictefy from '@predictefy/sdk';

const client = new Predictefy({ apiKey: process.env.PREDICTEFY_API_KEY });

const markets = await client.router.fetchMarkets({
  query: 'bitcoin',
  status: 'active',
  sort: 'volume',
  limit: 50,
});

for (const market of markets) {
  console.log(market.sourceExchange, market.title, market.volume24h, market.url);
}

Frequently Asked Questions