Polymarket API Keys

Connect your Polymarket account to trade prediction markets. You'll need a Builder API key from the Polymarket developer portal.

One key for US and World

You only need one Polymarket Builder API key. The same credentials work for US markets, global markets, or both — TraderBotz does not require separate keys per region.

What differs is routing (which Polymarket API endpoints the bot calls) and geo-access (whether a VPN is required for live trading on global markets). Your key, secret, and optional passphrase are stored encrypted in TraderBotz.

Market scope and VPN

When you create a prediction bot, you set market scope to usa, world, or all:

  • USA — Polymarket US (api.polymarket.us). No VPN required for live bots.
  • World — Polymarket Global (gamma-api.polymarket.com). Paper bots work without VPN. Live world-scope bots need VPN access: either the cloud VPN engine or a self-hosted node with WireGuard configured.
  • All — scans both US and global platforms (routing follows each market’s platform).

Step 1: Get Builder API Credentials

  1. 1 Go to the Polymarket developer portal and log in with your Polymarket account
  2. 2 Navigate to the API section and generate a Builder API Key
  3. 3 Copy your API Key, Secret, and Passphrase (if provided)

Step 2: Add to TraderBotz

  1. 1 Go to Accounts in the sidebar
  2. 2 Click Add Account and select Polymarket
  3. 3 Enter a name, paste the Builder API Key and Secret
  4. 4 Enter the passphrase if you received one (optional)
  5. 5 Click Test Connection and save

VPN: World-scope paper bots never require VPN. For live world-scope trading, use the cloud engine’s VPN path or set up WireGuard on a self-hosted node — see VPN Configuration.

← Robinhood Keys AI Providers →