market-selector

name	market-selector
description	Polymarket market discovery, filtering, and scoring engine — scan trending/new/closing markets, filter by volume/liquidity/expiry/category, and score on a 0-100 composite scale.

market-selector

Scan Polymarket for trading opportunities. An agent can use this to discover, filter, and rank prediction markets before making trading decisions.

GitHub: https://github.com/joyehuang/market-selector

Installation

pip install git+https://github.com/joyehuang/market-selector.git

Or with pip from git:

pip install market-selector

CLI Usage

# Scan trending markets (sorted by volume)
market-selector scan --scanner trending

# Scan all scanners at once (trending + new-markets + closing-soon)
market-selector scan --scanner all

# JSON output for programmatic consumption by the agent
market-selector scan --scanner trending --output json

# Custom result limit
market-selector scan --scanner new-markets --limit 10

# Continuous watch mode
market-selector watch --scanner trending

# List available scanners
market-selector scanners

# View scan history (requires Postgres persistence)
market-selector history

# Disable persistence for one-off runs
market-selector scan --scanner trending --no-save

Agent Integration

1. Install once (setup)

The agent should install the package once:

 subprocess
subprocess.run([, , ], check=)