mirror of
https://github.com/theodore-song/polymarket-analyst.git
synced 2026-07-27 16:07:46 +00:00
Theodore Song
68 lines
2.8 KiB
Markdown
68 lines
2.8 KiB
Markdown
# 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 frequent 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.
|