Polymarket

Search Polymarket events

Searches Polymarket and returns event results. The status enum accepts open, closed, and all; the sort enum accepts relevance, volume24hr, volume, liquidity, and endDate.

get/polymarket/search

Request

  • Base URL: https://api.crawlora.net/api/v1
  • URL: https://api.crawlora.net/api/v1/polymarket/search
  • Auth: API key in header x-api-key

Query parameters

qstring required

Search query

limitinteger

Maximum events, defaults to 10 and supports up to 50

status'open' | 'closed' | 'all'

Event status filter

sort'relevance' | 'volume24hr' | 'volume' | 'liquidity' | 'endDate'

Search sort

ascendingboolean

Sort ascending when true

include_tagsboolean

Include matching tags

include_profilesboolean

Include matching profiles

Headers

x-api-keystring required

API key required

Response

OK

codeinteger
msgstring

Example response

{
  "code": 200,
  "data": {
    "events": [
      {
        "id": "545095",
        "markets": [
          {
            "condition_id": "0x1a987cd4e88488fd12905fa9ae82cef381e03f4af68289275c4c0c2613db9327",
            "id": "558934",
            "outcomes": [
              {
                "best_ask": 0.162,
                "best_bid": 0.161,
                "last_trade_price": 0.162,
                "liquidity": 1093391.84,
                "market_id": "558934",
                "market_slug": "will-spain-win-the-2026-fifa-world-cup-963",
                "outcome": "Yes",
                "price": 0.1615,
                "question": "Will Spain win the 2026 FIFA World Cup?",
                "volume": 30983849.24
              }
            ],
            "question": "Will Spain win the 2026 FIFA World Cup?",
            "slug": "will-spain-win-the-2026-fifa-world-cup-963",
            "url": "https://polymarket.com/event/world-cup-winner/will-spain-win-the-2026-fifa-world-cup-963"
          }
        ],
        "markets_count": 15,
        "slug": "bitcoin-above-on-june-7-2026",
        "tags": [
          {
            "id": "21",
            "label": "Crypto",
            "slug": "crypto"
          }
        ],
        "title": "Bitcoin above ___ on June 7?",
        "url": "https://polymarket.com/event/bitcoin-above-on-june-7-2026"
      }
    ],
    "fetched_at": "2026-06-07T11:00:00Z",
    "limit": 10,
    "profiles": [
      {
        "id": "123",
        "name": "Trader",
        "username": "trader"
      }
    ],
    "query": "bitcoin",
    "sort": "relevance",
    "source_url": "https://gamma-api.polymarket.com/public-search?q=bitcoin&limit_per_type=10",
    "status": "open",
    "tags": [
      {
        "id": "21",
        "label": "Crypto",
        "slug": "crypto"
      }
    ],
    "total_results": 123
  },
  "msg": "OK"
}

Changes

No recorded changes to this operation across all 2 revisions of this API.