polybot — Polymarket from your terminal

Copy whales, run autonomous strategies, and place orders with one command. No servers, no dashboards, no SaaS account.

npm i -g polymarket-bot
polybot login
polybot scan
polybot trade --market will-eth-hit-10k --side BUY --usdc 25
polybot copy  --target 0xWhale --size-multiplier 0.05 --live

Node 20+. That's the only requirement.

Install

npm i -g polymarket-bot
polybot --help

Or run without installing:

npx polymarket-bot help

First run

polybot login

You'll be asked for your wallet key once. It is encrypted in transit, stored ciphertext-only, and wiped from memory immediately. The plaintext never lands on your disk and never appears in logs.

After login, the CLI keeps only an address + a short fingerprint locally so you can list and forget wallets:

polybot wallets list
polybot wallets forget 0xAbCd…1234

Commands

| Command | What it does | |---|---| | polybot login | Connect a wallet (one-time setup) | | polybot wallets list | Show connected wallets | | polybot wallets forget <addr> | Disconnect a wallet | | polybot scan | List trending Polymarket markets | | polybot quote | Live BUY/SELL quote for a market | | polybot trade | Place a single order (paper by default) | | polybot copy | Mirror trades from a Polymarket whale | | polybot auto | Run autonomous strategies (arbitrage / momentum / mean-reversion / endgame) | | polybot balances | USDC + CTF allowances | | polybot positions | Open positions with PnL | | polybot watch | Live stream of trade/order events |

Every trading command runs in paper mode by default. Add --live to commit real USDC.

Examples

polybot trade --market will-eth-hit-10k --side BUY --usdc 25 --live
polybot copy  --target 0xWhale --size-multiplier 0.05 --max-trade 50 --live
polybot auto  --strategies arbitrage,endgame --per-trade 25 --live

Wallet modes

Most users connect an EOA via polybot login and never touch env vars.

For Polymarket proxy wallets (Magic / Safe), set:

POLY_SIGNATURE_TYPE=1                       # 1 = Magic, 2 = Safe
POLY_FUNDER_ADDRESS=0xYourPolymarketProxy

For headless servers where interactive login is impossible, you can supply the key directly:

PRIVATE_KEY=0x… polybot auto --live

License

MIT.