Polybot US Setup Guide: Polymarket US Bot, API Key, FAQ & Tips

• AI agents: connect Claude Desktop, Claude Code, Cursor, Codex, Windsurf or VS Code over MCP. Each named agent gets your own guide, rules and caps, and a scoreboard checks whether it beats the market.
• Autopilot: the app runs one of your agents on a schedule with your own AI key, inside daily run and token budgets.
• Trading terminal: browse markets and trade from a full market page with a probability chart, order book, your position and an order ticket.
• Resolution risk: who resolves a market, on what source, how ambiguous the wording is, and whether a related market contradicts it.
• Cross-venue prices: the same question priced on Kalshi next to Polymarket US, read-only.
• Standing rules: stop loss, take profit and price alerts in probability points.
• Short-term crypto: the 5-minute, 15-minute and 1-hour Up/Down markets for BTC, ETH, SOL and XRP, with a configurable strategy and its own live switch.
• Strategy scripts: write Python strategies, backtest them, and run them in shadow mode before real money.
• AI analysis: a model reads a market's resolution rules and points out the traps. It gives a reading, never an invented probability.
• Remote control: check on the bot, or trade, from your phone over a Discord or Telegram bot you own.

Polybot US ships with one-click strategy presets. Each watches order flow, liquidity changes, whale-sized positions, spreads and momentum, and you can set them per category (politics, crypto, sports, culture, finance, news and others) on 5-minute, 15-minute or 1-hour windows.

• Momentum: follows markets whose price is moving sharply in one direction.
• Whale Follow: reacts when a whale-sized position enters a market. Set the whale size filter to suit the liquidity of the markets you trade.
• Sentiment Shift: looks for markets where the balance of opinion is changing.
• Volume Spike: reacts to sudden surges in trading volume.
• Trend Continuation: bets that an established move keeps going.
• Mean Reversion: the opposite bet, that a stretched price drifts back.
• Spread Scalp: works the gap between bid and ask, so it depends on liquidity and fees.
• Manual Mode: the bot watches and alerts; you make every decision.

Tune each with confidence thresholds, whale size filters, liquidity requirements, risk tolerance and timing windows, and cap it with take profit, stop loss, cooldowns and exposure limits. Momentum and Mean Reversion are opposite bets on the same move, so don't run both on one market.

Windows is the main build. The macOS and Linux builds get less testing.

1. Open the Polybot US page on krypt.cc. That page is the only official download; copies re-uploaded elsewhere can be modified.
2. Pick the build for your system (Windows, macOS or Linux).
3. Read and accept the Software Download Terms in the prompt. The file downloads as soon as you agree, and you won't be asked again for that tool until the terms change.
4. Optional but sensible: upload the file to VirusTotal before you run it.

Windows

1. Run the installer you downloaded.
2. If Windows SmartScreen says "Windows protected your PC", click More info, then Run anyway. Krypt builds aren't code-signed yet, so SmartScreen treats them as unrecognised apps. That warning is about the missing signature, not about anything it found in the file.
3. Follow the installer, then launch Polybot US from the Start menu or the desktop shortcut.

macOS

1. Open the download and drag Polybot US into your Applications folder.
2. The first time you open it, macOS blocks it because it's from an unidentified developer. Click Done, then go to System Settings → Privacy & Security, scroll down and click Open Anyway next to Polybot US. On macOS 14 and older you can instead right-click the app and choose Open.
3. If macOS instead says the app "is damaged and can't be opened", the file isn't damaged: Gatekeeper is refusing an unsigned download. Clear its quarantine flag once in Terminal, then open the app again:

xattr -cr "/Applications/Polybot US.app"

If you saved the app somewhere other than Applications, drag it from Finder into the Terminal window after xattr -cr to paste its real path.

Linux

The Linux build is an AppImage: one file, nothing to install. Make it executable, then run it:

chmod +x ./*.AppImage
./*.AppImage

Or right-click it in your file manager, tick Allow executing file as program in Properties, and double-click it.

The app opens in Paper mode. Paper trades the real order books with imaginary money, and it needs no API key, so you can try the terminal and connect an AI agent before you have an account. Without a key, order books come from public quotes, which the exchange caches for up to 30 seconds.

One thing to understand early: Paper covers your own orders and your AI agents. The automated engines (the crypto engine and live scripts) are not simulated. In Paper they send nothing at all, and once you go Live a switched-on engine trades for real. Every engine ships off.

The app walks you through this during onboarding and again on its API Key page.

1. Create an account at polymarket.us.
2. Verify your identity in the Polymarket US phone app. It asks for your date of birth, address and SSN. Polymarket US accounts are only for people who pass this check.
3. Create a key at polymarket.us/developer. You get a Key ID and a Secret Key. The Secret Key is shown only once, so copy it straight into the app.
4. In Polybot US, open API Key and paste both.

On Windows the key is encrypted at rest (DPAPI), tied to your user account, and only used to sign requests on your machine.

1. Open AI Agents and connect your client: Claude Desktop, Claude Code, Cursor, Codex, Windsurf or VS Code. No token goes into any config file.
2. Create a named agent and give it a guide, rules and caps.
3. Ask it to research markets and trade on paper.

The rails are enforced by the app's backend, not by the agent's prompt:

• A buy needs the agent's own recorded forecast to beat the price after fees.
• Live orders wait for your approval by default.
• An agent can only sell what it opened.
• Trade mode, caps and a daily loss stop apply to every order, whatever the agent says.
• Agents start on paper, and whole-account powers are a separate switch, off by default.

The scoreboard checks each agent's forecasts against the market price. Let it build a record before you trust an agent with money.

1. Add your API key (above).
2. Go to Settings → Account → Go live. The checklist tests your key and lists everything that will start spending.
3. Turn on only the engines you want. Each has its own switch, and nothing trades until you turn one on.
4. Set the breakers: daily stop-loss and take-profit, the lifetime drawdown breaker and trading-hours windows.

Buying NO stays locked until the live check has passed. Pause everything is one switch, and also works from your phone with /pause.

Write your own strategies in Python and backtest them on past markets you download or the app records. New scripts start in shadow mode: they record what they would have traded until you explicitly arm them. Hard money rails cap what any script can spend. Run the fee-aware backtest on your own recorded data before trusting any setting.

• Use Resolution risk before you trade a market. Prediction markets resolve on exact wording and a named source.
• A value the app couldn't get shows as —, never as a 0 you might trade on. Treat a dash as unknown.
• Settings → Data & privacy lists every outbound host with live call counts, and one switch turns them off.
• Remote trading from Discord or Telegram is a separate switch, off by default, and every order from chat needs a confirmation code.
• The app's Guide page explains each feature in more detail.