Polymarket

Query Polymarket prediction markets and trade from the terminal.

Setup

Read-only commands work immediately (no install needed).

For trading, order books, and price history, install the Polymarket CLI:

curl -sSL https://raw.githubusercontent.com/Polymarket/polymarket-cli/main/install.sh | sh

For trading, set up a wallet:

python3 {baseDir}/scripts/polymarket.py wallet-setup

Or manually configure

~/.config/polymarket/config.json

with your private key. See the CLI docs for details.

Commands

Browse Markets (no CLI needed)

# Trending/active markets
python3 {baseDir}/scripts/polymarket.py trending
Search markets
python3 {baseDir}/scripts/polymarket.py search "trump"
Get specific event by slug
python3 {baseDir}/scripts/polymarket.py event "fed-decision-in-october"
Get markets by category
python3 {baseDir}/scripts/polymarket.py category politics
python3 {baseDir}/scripts/polymarket.py category crypto

Order Book & Prices (CLI required, no wallet)

# Order book for a token
python3 {baseDir}/scripts/polymarket.py book TOKEN_ID
Price history

python3 {baseDir}/scripts/polymarket.py price-history TOKEN_ID --interval 1d

Wallet (CLI required)

python3 {baseDir}/scripts/polymarket.py wallet-setup
python3 {baseDir}/scripts/polymarket.py wallet-show
python3 {baseDir}/scripts/polymarket.py wallet-balance
python3 {baseDir}/scripts/polymarket.py wallet-balance --token TOKEN_ID

Trading (CLI + wallet required)

All trades require

--confirm

to execute. Without it, the order is previewed only.

# Buy limit order: 10 shares at $0.50
python3 {baseDir}/scripts/polymarket.py --confirm trade buy --token TOKEN_ID --price 0.50 --size 10
Sell limit order
python3 {baseDir}/scripts/polymarket.py --confirm trade sell --token TOKEN_ID --price 0.70 --size 10
Market order: buy $5 worth

python3 {baseDir}/scripts/polymarket.py --confirm trade buy --token TOKEN_ID --market-order --amount 5

Orders & Positions (CLI + wallet required)

# List open orders
python3 {baseDir}/scripts/polymarket.py orders
Cancel a specific order
python3 {baseDir}/scripts/polymarket.py --confirm orders --cancel ORDER_ID
Cancel all orders
python3 {baseDir}/scripts/polymarket.py --confirm orders --cancel all
View positions
python3 {baseDir}/scripts/polymarket.py positions
python3 {baseDir}/scripts/polymarket.py positions --address 0xYOUR_WALLET

Example Chat Usage

"What are the odds Trump wins 2028?"
"Trending on Polymarket?"
"Search Polymarket for Bitcoin"
"Show me the order book for [token]"
"Buy 10 shares of YES on [market] at $0.45"
"What are my open positions?"
"Cancel all my orders"

⚠️ Safety Notes

Real money. Trades execute on Polygon with real USDC. Double-check everything.
All trades require
--confirm
. Without it, you get a preview only.
The CLI is experimental. The Polymarket team warns: "Use at your own risk and do not use with large amounts of funds."
Private key security. Your key is stored in
```
~/.config/polymarket/config.json
```
. Keep it safe.
Gas fees. On-chain operations (approvals, splits, redeems) require MATIC for gas.

API

Read-only commands use the public Gamma API (no auth):

Base URL:
```
https://gamma-api.polymarket.com
```

Trading commands wrap the official Polymarket CLI (Rust binary).

Polymarket

AI Skill Market Insights

Be Part of the 0+ Developer Community

Polymarket

Setup

Commands

Browse Markets (no CLI needed)

Search markets

Get specific event by slug

Get markets by category

Order Book & Prices (CLI required, no wallet)

Price history

Wallet (CLI required)

Trading (CLI + wallet required)

Sell limit order

Market order: buy $5 worth

Orders & Positions (CLI + wallet required)

Cancel a specific order

Cancel all orders

View positions

Example Chat Usage

⚠️ Safety Notes

API

Quick Start

Manual Installation

TEAR & SHARE

Tags

Financial Analyst

Social Media Marketing

Xpoz Setup

lead-generating

stock-analysis-lianghua

Channels

Learn

Compare

Company