Skip to main content
Follow these steps to install the Polymarket CLI Research Tool on your system.

​
Install via Homebrew

The recommended installation method for macOS and Linux is Homebrew.
1

Add the Polymarket tap

First, add the Polymarket CLI tap to your Homebrew installation:
brew tap Polymarket/polymarket-cli https://github.com/Polymarket/polymarket-cli
This registers the official Polymarket CLI repository with Homebrew.
2

Install the CLI

Install the polymarket command:
brew install polymarket
Homebrew will download and install the CLI binary along with its dependencies.
3

Verify installation

Confirm the CLI is installed correctly and available on your PATH:
polymarket --help
You should see the help output listing all available commands and options.

​
Verify your setup

After installation, verify that all prerequisites are met.

​
Check Python version

The chart generation script requires Python 3.9 or higher: 
python3 --version
You should see output like Python 3.9.x or higher.

​
Test basic commands

Run a simple command to ensure the CLI can reach Polymarket APIs: 
polymarket --version

​
Verify PATH

If you encounter polymarket: command not found, check that the binary is on your PATH: 
which polymarket
This should output the path to the polymarket binary (typically /opt/homebrew/bin/polymarket on Apple Silicon or /usr/local/bin/polymarket on Intel Macs).

​
Troubleshooting

If the polymarket command is not found:
  1. Verify the CLI is installed: brew list | grep polymarket
  2. Check your PATH includes Homebrew’s bin directory
  3. Try reopening your terminal to refresh the PATH
  4. Run brew doctor to diagnose Homebrew issues
You can manually check the installation location:
ls -l $(brew --prefix)/bin/polymarket
If your Python version is below 3.9:macOS:
brew install [email protected]
Linux (Ubuntu/Debian):
sudo apt update
sudo apt install python3.11
Then verify:
python3 --version
The CLI requires internet access to query Polymarket APIs. If you see connection errors:
  1. Check your internet connection
  2. Verify you can reach https://clob.polymarket.com
  3. Check if a firewall or VPN is blocking requests
  4. Try using a different network
Test connectivity:
curl -I https://clob.polymarket.com/markets

​
Next steps

Quick start

Learn how to look up events, markets, and generate your first price chart

Build docs developers (and LLMs) love

Get started for freeTalk to us