bullpen polymarket search

Last updated: March 19, 2026

Search prediction markets and trader profiles

Usage

bullpen polymarket search [OPTIONS] <QUERY>

Live Help

Search prediction markets and trader profiles

Usage: bullpen polymarket search [OPTIONS] <QUERY>

Arguments:
  <QUERY>  Search query (text, slug, or Polymarket URL)

Options:
      --output <OUTPUT>  [possible values: table, json]
      --type <TYPE>      Filter by type: all, market, user [default: all]
      --env <ENV>        [possible values: staging, production]
      --limit <LIMIT>    Number of results per type
      --config <CONFIG>
      --status <STATUS>  Filter by market status: active, closed
  -h, --help             Print help

Smart Features

• URL detection: Paste a full Polymarket URL (e.g., https://polymarket.com/event/bitcoin-100k) — the slug is extracted and searched automatically.
• Smart retry: For market searches, if no results match, the query is simplified (numbers and special characters stripped) and retried. Output shows "No results for X. Showing results for Y instead."
• Market slugs: Table output includes the market slug below each result for easy copy-paste into trading commands.
• Fallback query: JSON output includes fallback_query when a simplified query was used.

Example Commands

# Basic text search
bullpen polymarket search "bitcoin"

# Search by Polymarket URL
bullpen polymarket search "https://polymarket.com/event/bitcoin-100k"

# Market-only search (enables smart retry)
bullpen polymarket search "bitcoin $100k!!" --type market

# JSON output for automation
bullpen polymarket search "election" --output json --limit 10

Example Data

Representative JSON shape for automation and integrations:

{
  "query": "bitcoin $100k",
  "fallback_query": "bitcoin k",
  "events": [
    {
      "id": "evt_1",
      "slug": "bitcoin-100k",
      "title": "Will Bitcoin hit $100k?",
      "markets": [
        {
          "id": "m1",
          "question": "Will Bitcoin hit $100k?",
          "slug": "will-bitcoin-hit-100k",
          "outcomes": [
            { "name": "Yes", "probability": 0.72, "price": 0.72 },
            { "name": "No", "probability": 0.28, "price": 0.28 }
          ],
          "warnings": []
        }
      ]
    }
  ],
  "profiles": [],
  "has_more": false
}