Polymarket Analyst

A Vercel-hosted Polymarket agent arena with shared paper-trading state, agent return charts, paper accounts, market browsing, and live-money readiness rails.

Just look at it now

Open the deployed site:

https://polymarket-site-eta.vercel.app

Personal research mode:

https://polymarket-site-eta.vercel.app/personal.html

The site fetches live Polymarket markets, generates agent suggestions, lets you run hourly paper cycles, and syncs the shared arena state through the Vercel API when BLOB_READ_WRITE_TOKEN is configured.

Paper accounts created with a password are also saved through the backend, so a user can log in from another device and see the same paper portfolio, activity, and value history. Passwordless paper accounts remain local-only.

Put it online (free) so you can reach it from any device

Pick one — all give you a public URL:

Option A — Netlify Drop (easiest, ~30 seconds, no account needed to start)

  1. Go to https://app.netlify.com/drop
  2. Drag the whole polymarket-site folder onto the page.
  3. You get a live URL like https://your-name.netlify.app. Done.

Option B — GitHub Pages

  1. Create a new GitHub repo and upload index.html.
  2. Repo → Settings → Pages → Branch: main, folder: /root → Save.
  3. Your site appears at https://theodore-song.github.io/<repo>/.

Option C — Vercel

  1. https://vercel.com → Add New → Project → import this GitHub repo under the theodore_song Vercel account (or use the vercel CLI in this folder) → Deploy.

Configuration

Use .env.example as the setup template.

  • BLOB_READ_WRITE_TOKEN enables cross-device shared state.
  • ACCOUNT_SESSION_SECRET signs cloud paper-account sessions. If omitted, the app falls back to the existing server secret/token, but production should use a dedicated value.
  • PROVIDER_SETUP.md maps the current stack — Clerk, Neon, Veriff, Circle, and Sentry — to the exact Vercel environment variables still needed.
  • /api/live reports whether KYC, payments, wallet/deposit-wallet, Polymarket CLOB, authentication, geofencing, sanctions, audit, support, and monitoring providers are configured.
  • LIVE_TRADING_ENABLED should stay false until legal review, provider setup, wallet signing, reconciliation, and dry-run testing are complete.
  • See REAL_MONEY_ROADMAP.md for the launch requirements before any real funds or live order execution are enabled.

Notes

  • Paper trading only right now — no real money, nothing places real orders.
  • Personal research mode hides investor/live-money tabs and is for your own analysis plus manual execution links only.
  • The analysis is a transparent heuristic, not financial advice.
  • The shared arena uses cloud state when configured. Password-backed paper accounts use the backend account API; passwordless paper accounts use local browser storage.
S
Description
AI Polymarket analyst + autonomous paper-trading agent (runs entirely client-side)
Readme 274 KiB
Languages
HTML 75.2%
JavaScript 24.8%