What the bot is
The PR&R Up/Down Crypto Bot is an open-source bot that trades Polymarket's short-term crypto markets — the ones that ask “will BTC (or ETH, SOL, XRP, BNB, DOGE) be up or down at the end of this window?” It watches those markets, reads live coin prices, runs a strategy you choose, and places the trades for you through your own wallet.
Each side of a market (Up or Down) is a token priced between $0 and $1 — read it as cents and as an implied probability. If your side wins when the window closes, each share pays out $1.
How the bot works
The bot is a small team of background programs (called engines) plus a dashboard you run in your browser. You don't need to understand the internals — some engines gather data, and others place the trades.
The flow is simple:
- It watches the markets — live prices and time remaining for every coin and timeframe.
- It reads real coin prices and measures how far each coin has moved since the round opened.
- Your strategy decides whether the conditions are right to buy.
- It places the order through your own wallet, and logs every trade locally.
You stay in control the whole time: you pick the coins and timeframes, choose the strategy, set the risk, and flip between paper and live.
The dashboard
Everything runs from one screen with three parts:
- Left — engine controls. Start and stop the engines, see which are running, switch between paper and live, and open settings.
- Middle — the market grid. Every coin and timeframe as a live tile showing the time left and the current Up/Down prices. Click Up or Down to place a trade yourself.
- Right — your money. Your live Polymarket profit/loss, your open positions, and a full history of every trade (paper and live).
You can also watch each engine's live log to see what it's doing and why, and export or import your whole setup as a single file.
The two strategies
A strategy is how the bot decides to buy. There are two — pick one (or run both).
Expiry Sniper
Waits until a market is almost over and one side is nearly certain, then buys that side and holds it to the $1 payout. Because there are only seconds left, there's little room for the price to reverse — so it books small, frequent wins. You set how close to the end it acts and how certain the price has to be.
Scalper
Buys a token the moment its price drops into a range you set, then sells as soon as the price rises by the amount of profit you want. It's the simplest way to work short-term moves — you choose the buy range and the profit target, and the bot handles the rest.
The engines that support the strategies
Behind the two strategies, a few engines gather the data they need. You rarely touch these directly — here's what each one is and how the bot uses it.
Polymarket Feed
The price backbone. It streams the live Up/Down prices from Polymarket to the rest of the bot. Every strategy reads from it — if this engine isn't running, the bot sees no prices and won't trade.
Coin Delta
Reads the real dollar price of each coin (from Chainlink or Coinbase) and measures how far it has moved since the round opened. It uses that to suggest a bet size and a direction, so the strategies can size their trades and avoid buying against a strong move.
Wallet Feed
Tracks your Polymarket wallet in real time — every fill, position, and balance change — so the profit/loss on your dashboard is always accurate. It's read-only: it never places or signs a trade.
Stop loss & safety
Stop Loss
A safety feature, not a strategy. It watches the positions your strategies open and, if one is heading for a loss before the market ends, it exits early — recovering some of your money instead of losing the whole stake. It's off by default; turn it on if your strategy needs it.
How the bot keeps you safe
- Paper trading is on by default — nothing real happens until you choose to go live, which takes a deliberate confirmation.
- It's self-hosted. The bot runs on your machine and signs trades with your own wallet — nothing is held by anyone else.
- It's open source. Every strategy and setting is readable — no black box.
The settings that matter
You don't need to touch most settings. These are the ones that shape how each strategy trades — all editable in the dashboard, and saved changes take effect right away.
Expiry Sniper
| Setting | What it does |
|---|---|
| Probability band | The price range it will buy in (e.g. 94–99¢). Higher = only the safest markets; lower = more trades but more risk. |
| Time threshold | How close to the end it acts. Later = safer, since there's less time to reverse. |
| Bet size | How much to put on each trade. |
Scalper
| Setting | What it does |
|---|---|
| Buy range | The price range a token must fall into before it buys. |
| Exit gain | How much profit to wait for before selling. |
| Bet size | How much to put on each trade. |
| Coins | Which coins it's allowed to trade. |
Where coin prices come from
The bot needs live coin prices to measure movement. You choose the source in the dashboard — you can switch at any time.
| Source | Notes |
|---|---|
| Coinbase | Built in, no setup needed. The default. |
| Chainlink | Matches the prices Polymarket settles on — recommended if you have access. |
| Binance | Built in, but blocked in some regions. |
| PR&R | A hosted feed of Chainlink prices; needs a PR&R API key. |
Set your values from real data
The most important settings — how big a move should trigger a trade, and where to set your stop loss — shouldn't be guessed. Instead, look at what actually happened in past markets and let the data decide.
- Download PR&R's historical records of past Polymarket cycles.
- Measure how often each coin moved a given amount and then reversed.
- Use those numbers to set your trigger and stop-loss values.
Setup & going live
What you need before you start:
| You need | What it's for |
|---|---|
| Polymarket account + USDC | The place you trade, and your funds. |
| A dedicated wallet | Signs your trades — use a brand-new wallet, not one holding assets you care about. |
| An EU VPN or AWS relay | Polymarket blocks non-EU connections, so you need one of these to reach it. |
| Chainlink key (optional) | For the most accurate price feed; Coinbase works without it. |
The four steps
- Create your account and connect your Discord to unlock the download.
- Install and run in paper mode — paper trading is already on, so nothing is at risk.
- Configure it — add your details, pick coins and timeframes, and set your strategy.
- Go live carefully — when the decisions look right, switch to live and start small.
Extending the bot with plugins
The bot is built to be extended. You can import a plugin — a small feature pack — straight from the dashboard, with no rebuilding. A plugin can add a new engine, a new setting, or a rule that vetoes a trade (for example, “don't buy while the market is too volatile”).
Common issues
- On Windows? Run the bot under WSL (the Linux layer) — that's the supported setup.
- Can't download or trade? Downloads and live trading need your Discord connected to your account.
- Engines won't start trading? The trading engines need your Polymarket wallet details before they'll run.
- Prices are blank? The chosen price feed isn't reaching you — switch to Chainlink, which is the most reliable.
