Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.polymarket.us/llms.txt

Use this file to discover all available pages before exploring further.

The Search resource provides full-text search across events and markets.

​
Methods

MethodEndpointDescription
query(params?)GET /v1/searchSearch events and markets

​
query

Search for events and markets by text query. 
const results = await client.search.query({
  query: 'bitcoin',
  limit: 10,
});

for (const event of results.events) {
  console.log(event.title);
  for (const market of event.markets ?? []) {
    console.log(`  - ${market.question}`);
  }
}

​
Parameters

ParameterTypeDescription
querystringSearch query text
limitnumberMaximum results to return
pagenumberPage number for pagination
seriesIdsnumber[]Filter by series IDs
marketTypestring[]Filter by market types
statusstringFilter by status

​
Response

Returns events with their associated markets that match the search query: 
{
  events: [
    {
      id: 123,
      title: 'Bitcoin Price Markets',
      slug: 'bitcoin-price',
      markets: [
        {
          id: 456,
          question: 'Will Bitcoin reach $100k?',
          slug: 'btc-100k-2025',
        },
      ],
    },
  ],
}