PolyEdge
Browse documentation

How PolyEdge Works

PolyEdge is a thin, non-custodial layer on top of Polymarket. You authorise it, configure a strategy, and a dedicated engine runs that strategy for you. It never holds your funds.

Sign-in with your wallet

Authentication uses Sign-In with Ethereum (SIWE). You connect a wallet on Polygon and sign a one-time message — no password, no custody, no gas. That signature establishes your session; your wallet address is your identity on the platform.

The bot lifecycle

  1. 1

    Configure

    You set the strategy parameters and risk limits and save them. Configuration is stored against your account.
  2. 2

    Start

    Pressing Start marks the bot active. A dedicated worker process picks it up within a few seconds and begins a poll loop.
  3. 3

    Poll

    On each cycle the bot reads live Polymarket data (positions, order books, prices), decides whether to act under your rules, and — in live mode — places orders through the Polymarket CLOB.
  4. 4

    Heartbeat

    Each cycle writes a heartbeat (last sync time, last error) so the dashboard can show accurate status even though execution runs elsewhere.
  5. 5

    Stop

    Pressing Stop halts the loop. Open positions remain — stopping a bot does not liquidate anything.

Execution runs separately from the UI

Your bots run on a dedicated execution engine, separate from the web dashboard. This keeps order timing crisp and unaffected by chart rendering or UI traffic: the dashboard reads the engine's latest scan and heartbeat from the database, so the page stays fast while the bot keeps trading in the background — even if you close the tab.

Where your data lives
Strategy configs, trades, and performance are stored against your account. Live trading credentials (a wallet private key, optional API keys) are encrypted at rest and are never displayed again after you save them. See Security & Custody.