analysis-poly 0.1.2

Polymarket real-profit web analyzer

analysis-poly

Real Profit (Fee-Excluded View)

中文说明见：README_zh.md

Polymarket real-profit analyzer with a web UI.

Scope (Important)

• This tool is primarily designed for Polymarket crypto updown markets with taker fees.
• The dashboard first discovers participated slugs from Polymarket user activity within the selected time range, then replays only the matched markets.
• It is not intended as a universal PnL engine for all Polymarket market types.
• Main purpose: quantify and visualize the impact of trading fees on real profitability (Net PnL vs No-Fee PnL).

Requirements

• Python 3.11+ (recommended: 3.11)
• uv package manager

Install As Package

uv pip install .
# or
pip install .

After install:

analysis-poly
analysis-poly-open --address 0xabc --keywords updown,15m

Run

uv sync
uv run python main.py

Open http://localhost:8000.

CLI Open + Auto Start

Use a standalone script to start server, open browser, and pass params in URL.

uv run -m analysis_poly.open_with_params \
  --address 0xabc \
  --keywords updown,15m \
  --start-time "2026-03-01 00:00" \
  --end-time "2026-03-02 00:00" \
  --concurrency 8

Frontend will read query params, fill form fields, and auto start the run.

First Clone

analysis_poly/static/dist is committed in the repository, so first startup does not require front-end build.

If you modify frontend/src, rebuild assets:

npm install
npm run build

API

• POST /api/runs
• GET /api/runs/{run_id}/stream (SSE)
• POST /api/runs/{run_id}/stop
• GET /api/runs/{run_id}/result
• GET /api/runs/{run_id}/state

Test

uv run pytest

Frontend

• Source: frontend/src
• Build output: analysis_poly/static/dist/app.js and analysis_poly/static/dist/app.css