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. 
results = client.search.query({
    "query": "bitcoin",
    "limit": 10,
})

for event in results["events"]:
    print(f"{event['title']}")
    for market in event.get("markets", []):
        print(f"  - {market['question']}")

​
Parameters

ParameterTypeDescription
querystrSearch query text
limitintMaximum results to return
pageintPage number for pagination
seriesIdslist[int]Filter by series IDs
marketTypelist[str]Filter by market types
statusstrFilter 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"
                }
            ]
        }
    ]
}