PARTNER API

Backtest wallets
from your bot.

One API call to simulate any Polymarket wallet with real delays, fees, and slippage. Know if a wallet is worth copying before you deploy capital.

Request API Access See How It Works

Built for copy-trading teams

Sub-minute accuracy

Tick-level pricing from real Polymarket trades. Test 2s, 5s, 30s delays — not just minute candles.

L2 orderbook slippage

Point-in-time L2 snapshots simulate realistic fill prices based on actual liquidity depth.

Settlement-aware P&L

Resolved markets use actual settlement prices. No lookahead bias. Accurate win rates.

Multi-delay comparison

Test multiple copy delays in a single run. See exactly where edge degrades.

Idempotent & retry-safe

Idempotency-Key header prevents duplicate runs on retries. Safe for automated pipelines.

Full trade export

Download every simulated trade as CSV. Feed into your own analytics or risk models.

Three API calls

Create a simulation, poll for results, download the full trade log.

1Create simulationPOST /api/v1/simulations

curl -X POST https://polycopysim.com/api/v1/simulations \
  -H "Authorization: Bearer pcs_live_..." \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: wallet-scan-001" \
  -d '{
    "wallets": ["0x1234...abcd"],
    "startTs": 1711929600,
    "endTs": 1712534400,
    "fixedUsdcPerTrade": 100,
    "initialCapitalUsdc": 10000,
    "delaysSec": [0, 5, 30, 120],
    "slippageBps": 10,
    "pricingSource": "TRADES"
  }'

2Poll for resultsGET /api/v1/simulations/:id

{
  "requestId": "req_abc123...",
  "data": {
    "status": "DONE",
    "summary": [{
      "wallet": "0x1234...abcd",
      "realWallet": { "pnlUsdc": 2340.50, "turnoverRoiPct": 23.4, "winRate": 68.2 },
      "bestFixed": { "delaySec": 5, "pnlUsdc": 2180.30, "turnoverRoiPct": 21.8, "winRate": 66.1 },
      "proportional": [
        { "delaySec": 5, "capitalRoiPct": 18.2, "maxDrawdownPct": 6.4 },
        { "delaySec": 30, "capitalRoiPct": 15.1, "maxDrawdownPct": 8.9 }
      ]
    }]
  }
}

3Export tradesGET /api/v1/simulations/:id/export

curl -o trades.csv https://polycopysim.com/api/v1/simulations/clx.../export \
  -H "Authorization: Bearer pcs_live_..."

# Or gzipped for faster download
curl -o trades.csv.gz ".../export?format=gz" \
  -H "Authorization: Bearer pcs_live_..."

Per-simulation output

Summary JSON

Real wallet P&L (ground truth)
Fixed-amount simulation (multiple delays)
Proportional simulation (capital-weighted)
Win rate, max drawdown, loss streaks
Carry-in risk assessment
Data coverage & truncation flags

Full trades CSV

Every trade: source timestamp, copy timestamp, execution price
P&L per trade, cumulative P&L curve
Skip reasons (no price, no inventory, resolved)
Execution price source (tick, minute, orderbook)
Market name, outcome, tx hash
Streaming download (CSV or gzipped)

Technical details

Authentication

Bearer API keys with scoped permissions. Keys are SHA-256 hashed at rest. Revocable instantly.

Idempotency

Send Idempotency-Key header. Retries return cached results. No duplicate runs.

Rate limits

10 creates/min, 60 reads/min, 20 exports/min. Standard X-RateLimit-* headers.

Use cases

Teams already using the API

Copy-trading bots

Screen wallets before adding them to your copy pool. Filter by delay tolerance, drawdown, and win rate.

Wallet scanners

Batch-test top Polymarket wallets nightly. Rank by copyability score and notify your team.

Risk dashboards

Feed simulation results into your internal risk tools. Track edge decay across your copied wallets.

Quant research

Export full trade logs for custom analysis. Build your own alpha models on top of our simulation engine.

Ready to integrate?

We'll set up a staging API key for your team. Typical integration takes less than a day.

Request API Access View Pricing

API access is currently granted manually to approved teams. Staging keys are available for evaluation.

Backtest walletsfrom your bot.