Skip to content

Commit 6922da8

Browse files
committed
chore: rebrand to polymarket-on-paper under parle-ai
- Rename project from polymarket-paper-trader to polymarket-on-paper - Update authors to parle-ai, URLs to parle-ai/polymarket-on-paper - Rename docs/plans/ files for clarity (remove pm-sim prefix) - Add fork attribution in CHANGELOG, CLAUDE.md, README, SKILL.md - Set origin remote to parle-ai/polymarket-on-paper Made-with: Cursor
1 parent 36f4641 commit 6922da8

9 files changed

Lines changed: 45 additions & 58 deletions

File tree

CHANGELOG.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,8 @@
11
# Changelog
22

3-
All notable changes to `polymarket-paper-trader` are documented here.
3+
All notable changes to `polymarket-on-paper` are documented here.
4+
5+
> Forked from [agent-next/polymarket-paper-trader](https://github.com/agent-next/polymarket-paper-trader) at v0.1.7.
46
57
## Unreleased
68

CLAUDE.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,10 +2,12 @@
22

33
This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
44

5-
# polymarket-paper-trader
5+
# polymarket-on-paper
66

77
Paper trading simulator for Polymarket. Built for AI agents. Python 3.10+, SQLite, Click CLI, FastMCP.
88

9+
Forked from [agent-next/polymarket-paper-trader](https://github.com/agent-next/polymarket-paper-trader). Repository: [parle-ai/polymarket-on-paper](https://github.com/parle-ai/polymarket-on-paper).
10+
911
## Commands
1012

1113
```bash

README.md

Lines changed: 6 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -1,22 +1,19 @@
1-
# polymarket-paper-trader
1+
# polymarket-on-paper
22

3-
[![PyPI](https://img.shields.io/pypi/v/polymarket-paper-trader.svg)](https://pypi.org/project/polymarket-paper-trader/)
4-
[![Tests](https://github.com/agent-next/polymarket-paper-trader/actions/workflows/test.yml/badge.svg)](https://github.com/agent-next/polymarket-paper-trader/actions/workflows/test.yml)
5-
[![ClawHub](https://img.shields.io/badge/ClawHub-install-orange.svg)](https://clawhub.com/robotlearning123/polymarket-paper-trader)
6-
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://github.com/agent-next/polymarket-paper-trader/blob/main/LICENSE)
3+
[![Tests](https://github.com/parle-ai/polymarket-on-paper/actions/workflows/test.yml/badge.svg)](https://github.com/parle-ai/polymarket-on-paper/actions/workflows/test.yml)
4+
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://github.com/parle-ai/polymarket-on-paper/blob/main/LICENSE)
75

86
**Your AI agent just became a Polymarket trader.**
97

108
Install → your agent gets $10,000 paper money → trades real Polymarket order books → tracks P&L → competes on a public leaderboard. Zero risk. Real prices.
119

1210
> "My AI agent hit +18% ROI on Polymarket in one week. Zero risk, real order books."
1311
14-
Part of [agent-next](https://github.com/agent-next) — open research lab for self-evolving autonomous agents.
12+
Forked from [agent-next/polymarket-paper-trader](https://github.com/agent-next/polymarket-paper-trader). Built by [parle-ai](https://github.com/parle-ai).
1513

1614
## 60-second demo
1715

1816
```bash
19-
npx clawhub install polymarket-paper-trader # install via ClawHub
2017
pm-trader init --balance 10000 # $10k paper money
2118
pm-trader markets search "bitcoin" # find markets
2219
pm-trader buy will-bitcoin-hit-100k yes 500 # buy $500 of YES
@@ -28,14 +25,8 @@ That's it. Your AI agent is now trading Polymarket with zero risk.
2825
## Install
2926

3027
```bash
31-
# via pip
32-
pip install polymarket-paper-trader
33-
34-
# via ClawHub (for OpenClaw agents)
35-
npx clawhub install polymarket-paper-trader
36-
3728
# from source (development)
38-
uv pip install -e ".[dev]"
29+
pip install -e ".[dev]"
3930
```
4031

4132
Requires Python 3.10+.
@@ -240,14 +231,6 @@ pm-trader stats --plain # plain text
240231

241232
AI agents can use the `stats_card` MCP tool to generate and share cards automatically.
242233

243-
## OpenClaw / ClawHub
244-
245-
Available on [ClawHub](https://clawhub.com) as `polymarket-paper-trader`:
246-
247-
```bash
248-
npx clawhub install polymarket-paper-trader
249-
```
250-
251234
## Tests
252235

253236
```bash
@@ -260,4 +243,4 @@ pytest tests/test_e2e_live.py # live API integration tests only
260243

261244
MIT
262245

263-
<!-- mcp-name: io.github.agent-next/polymarket-paper-trader -->
246+
<!-- mcp-name: io.github.parle-ai/polymarket-on-paper -->
Lines changed: 21 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -374,36 +374,36 @@ polymarket/
374374

375375
## 10. Roadmap
376376

377-
### Phase 1 — 1:1 Faithful MVP (Current)
377+
### Phase 1 — 1:1 Faithful MVP
378378

379-
- [ ] Project scaffolding + models
380-
- [ ] SQLite database layer
381-
- [ ] Polymarket API client (Gamma + CLOB + fee-rate + tick-size)
382-
- [ ] **Order book fill engine** (walk book, slippage, FOK/FAK)
383-
- [ ] Trade engine (buy/sell/portfolio/resolve using real book execution)
384-
- [ ] CLI commands
385-
- [ ] Integration tests with realistic order book fixtures
386-
- [ ] README
379+
- [x] Project scaffolding + models (`models.py`)
380+
- [x] SQLite database layer (`db.py`)
381+
- [x] Polymarket API client Gamma + CLOB + fee-rate + tick-size (`api.py`)
382+
- [x] **Order book fill engine** walk book, slippage, FOK/FAK (`orderbook.py`)
383+
- [x] Trade engine buy/sell/portfolio/resolve using real book execution (`engine.py`)
384+
- [x] CLI commands — 20+ commands (`cli.py`)
385+
- [x] Integration tests — 615 non-live + 42 live, 100% coverage
386+
- [x] README
387387

388-
### Phase 2 — Benchmarking & Analytics
388+
### Phase 2 — Benchmarking & Analytics
389389

390-
- [ ] `performance` command (win rate, P&L, Sharpe, max drawdown)
391-
- [ ] Multi-account support (`--account agent-a`)
392-
- [ ] Benchmark harness (run N agents, compare results)
393-
- [ ] `history --export csv`
390+
- [x] `performance` command win rate, P&L, Sharpe, max drawdown (`analytics.py`, `card.py`)
391+
- [x] Multi-account support `--account` flag, separate SQLite per account
392+
- [x] Benchmark harness run N agents, compare, PK battle (`benchmark.py`)
393+
- [x] `history --export csv` — CSV + JSON export (`export.py`)
394394

395-
### Phase 3 — Advanced Orders
395+
### Phase 3 — Advanced Orders
396396

397-
- [ ] GTC limit orders (rest on simulated book until price hit)
398-
- [ ] GTD time-limited orders
399-
- [ ] `watch` real-time price monitoring
397+
- [x] GTC limit orders rest on simulated book until price hit (`orders.py`)
398+
- [x] GTD time-limited orders — expire at timestamp
399+
- [x] `watch` real-time price monitoring
400400
- [ ] Neg-risk multi-outcome market support
401401

402-
### Phase 4 — Platform Expansion
402+
### Phase 4 — Platform Expansion (partial)
403403

404404
- [ ] Kalshi adapter
405-
- [ ] Historical data backtesting
406-
- [ ] MCP Server mode
405+
- [x] Historical data backtesting (`backtest.py`)
406+
- [x] MCP Server mode — 30 tools (`mcp_server.py`)
407407
- [ ] WebSocket real-time feeds
408408

409409
## 11. Dependencies
File renamed without changes.
File renamed without changes.

pyproject.toml

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -3,10 +3,10 @@ requires = ["setuptools>=78.1.1"]
33
build-backend = "setuptools.build_meta"
44

55
[project]
6-
name = "polymarket-paper-trader"
6+
name = "polymarket-on-paper"
77
version = "0.1.7"
88
description = "Your AI agent trades Polymarket — $10k paper money, real prices, zero risk. Compete on the leaderboard."
9-
authors = [{name = "agent-next"}]
9+
authors = [{name = "parle-ai"}]
1010
license = "MIT"
1111
readme = "README.md"
1212
requires-python = ">=3.10"
@@ -38,9 +38,9 @@ include = ["pm_trader*"]
3838
markers = ["live: tests requiring network access to Polymarket API"]
3939

4040
[project.urls]
41-
Homepage = "https://pypi.org/project/polymarket-paper-trader/"
42-
Repository = "https://github.com/agent-next/polymarket-paper-trader"
43-
Issues = "https://github.com/agent-next/polymarket-paper-trader/issues"
41+
Homepage = "https://github.com/parle-ai/polymarket-on-paper"
42+
Repository = "https://github.com/parle-ai/polymarket-on-paper"
43+
Issues = "https://github.com/parle-ai/polymarket-on-paper/issues"
4444

4545
[project.scripts]
4646
pm-trader = "pm_trader.cli:main"

server.json

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,14 @@
11
{
22
"$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
3-
"name": "io.github.agent-next/polymarket-paper-trader",
4-
"title": "Polymarket Paper Trader",
3+
"name": "io.github.parle-ai/polymarket-on-paper",
4+
"title": "Polymarket On Paper",
55
"description": "Paper trading simulator for Polymarket prediction markets. $10k paper money, real order books, zero risk. Built for AI agents.",
6-
"version": "0.1.6",
6+
"version": "0.1.7",
77
"packages": [
88
{
99
"registryType": "pypi",
10-
"identifier": "polymarket-paper-trader",
11-
"version": "0.1.6",
10+
"identifier": "polymarket-on-paper",
11+
"version": "0.1.7",
1212
"transport": {
1313
"type": "stdio"
1414
}

skill/polymarket-paper-trader/SKILL.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ metadata:
1313
package: polymarket-paper-trader
1414
bins: [pm-trader, pm-trader-mcp]
1515
emoji: "🎯"
16-
homepage: "https://github.com/agent-next/polymarket-paper-trader"
16+
homepage: "https://github.com/parle-ai/polymarket-on-paper"
1717
tags:
1818
- polymarket
1919
- trading
@@ -193,4 +193,4 @@ Trusted sources are limited to: this SKILL.md, the MCP tools provided by `pm-tra
193193

194194
## Source
195195

196-
[github.com/agent-next/polymarket-paper-trader](https://github.com/agent-next/polymarket-paper-trader) — MIT License. Real order book simulation, not mock data.
196+
[github.com/parle-ai/polymarket-on-paper](https://github.com/parle-ai/polymarket-on-paper) — MIT License. Real order book simulation, not mock data. Forked from [agent-next/polymarket-paper-trader](https://github.com/agent-next/polymarket-paper-trader).

0 commit comments

Comments
 (0)