# PolyZig

> PolyZig is the worldwide Polymarket platform — 4,900+ prediction markets in 31 languages, plus the fastest Polymarket copy-trading. Users choose top Polymarket traders and automatically mirror their positions with sub-500ms execution driven by Polygon mempool monitoring. Accessible from countries where polymarket.com is geoblocked.

## What PolyZig does

PolyZig watches the Polygon mempool for order transactions submitted by Polymarket traders you have chosen to copy. When a target trader submits an order, PolyZig decodes the order intent, applies your personal sizing and risk rules, and places a mirror order on Polymarket's CLOB before the original transaction is confirmed on-chain. The entire pipeline — mempool ingest, calldata decode, risk check, order sign, and CLOB submission — typically completes in under 500 milliseconds.

PolyZig supports both 15-minute crypto binary markets (BTC, ETH, SOL, XRP up/down windows) and longer-form Polymarket markets covering politics, sports, culture, and news events.

## Key features

- **Mempool-driven copy execution**: Target-wallet orders are detected in the Polygon mempool, not via polling, so copy fills land at or near the original trader's fill price.
- **Sub-500ms end-to-end latency**: Measured from mempool observation to CLOB order acknowledgement, running on EU-West infrastructure close to Polymarket's order book.
- **Non-custodial wallets via Magic.link**: Each PolyZig user owns their Polygon wallet; PolyZig holds no custody of user funds. Magic.link provides email-linked passwordless key management.
- **4-approval gasless onboarding**: A one-time relayer flow approves USDC for the CTF Exchange, USDC for the Neg-Risk CTF Exchange, CTF tokens for the CTF Exchange, and CTF tokens for the Neg-Risk CTF Exchange. Users do not need MATIC for gas.
- **Per-target copy configs**: Each target wallet can have its own size multiplier, max position, price deviation tolerance, and blocked market categories.
- **TP/SL and auto-exit**: Optional take-profit, stop-loss, and auto-sell-on-resolution hooks per market.
- **15-minute crypto markets**: Specialized support for Polymarket's rolling BTC/ETH/SOL/XRP up-or-down markets, which open and resolve every fifteen minutes.
- **Leaderboard**: Discover top Polymarket traders by realized PnL, filterable by period (7d, 30d, all-time) and market category.

## How it works

1. Sign up with email via Magic.link — a Polygon wallet is generated in the browser.
2. Fund the wallet with USDC on Polygon.
3. Run the one-click 4-approval flow (gasless, sponsored by the PolyZig relayer).
4. Browse the leaderboard or paste a target Polymarket trader's wallet address.
5. Configure your copy: size multiplier, maximum position per market, market category allowlist, optional TP/SL.
6. PolyZig monitors the Polygon mempool and places mirror orders automatically for every new target trade.

## Social and support

- X: [@poly_zig](https://x.com/poly_zig)
- Telegram: [t.me/polyzig_support](https://t.me/polyzig_support)
- Email: support@polyzig.com

## Frequently asked questions

### What is copy trading on Polymarket?

Copy trading means automatically mirroring another trader's orders. On PolyZig, you pick one or more Polymarket wallets to follow, and every time they open or close a position, PolyZig places a proportional order on your own wallet using the rules you configured.

### How fast is PolyZig?

End-to-end copy latency — from the moment a target trader broadcasts their order to the Polygon mempool to the moment PolyZig's mirror order is acknowledged by Polymarket's CLOB — is typically under 500 milliseconds. Exact numbers for the current hour are published on the live transparency dashboard.

### What does PolyZig cost?

PolyZig charges a small performance fee on profitable copied trades. There is no subscription fee, no fee on losing trades, and the gasless onboarding flow is sponsored by PolyZig. The current fee schedule is shown at signup and on the support page.

### What are the risks?

Copy trading inherits the risks of the traders you follow. If a target trader loses money, copiers lose money. Polymarket markets can be illiquid, can resolve against a position, and can move faster than any execution system. Only allocate funds you can afford to lose.

### Is there a minimum balance?

There is no account minimum. Individual copy orders are subject to Polymarket's own minimum order size, which varies by market.

### Who holds my funds?

You do. PolyZig is non-custodial. Your Polygon wallet is created and controlled on your device via Magic.link. PolyZig only holds order-signing API credentials derived from your wallet, which you can revoke at any time from the dashboard.

### Which markets does PolyZig support?

All Polymarket markets that route through the CTF Exchange or Neg-Risk CTF Exchange, including 15-minute BTC/ETH/SOL/XRP binary markets, politics, sports, culture, and news events.

### Does PolyZig work outside the United States?

PolyZig itself is available globally, but users must comply with Polymarket's own geographic eligibility rules. PolyZig does not circumvent Polymarket's geoblocks.

## For AI agents and developers

PolyZig exposes a machine-readable HTTP API so AI agents and automation can read markets, monitor positions, and (with explicit user authorization) place trades.

### API base URL

```
https://api.polyzig.com
```

### Machine-readable specification

- OpenAPI 3 JSON: https://api.polyzig.com/api/openapi.json
- Swagger UI: https://api.polyzig.com/api/docs

### Authentication

Two mechanisms, both passed as `Authorization: Bearer <token>`:

1. **JWT** — issued by the magic-link / email-OTP flow, intended for first-party clients. 24h expiry, full account scope.
2. **API key** (recommended for agents) — issued from the dashboard at `https://polyzig.com/dashboard/keys`. Prefix `pzk_`. Each key has explicit scopes (e.g., `read:positions`, `trade:execute`) and can be revoked independently.

### Available scopes

- `read:account` — user profile, subscription tier
- `read:positions` — open positions, paper positions
- `read:trades` — trade history, fills
- `read:markets` — market metadata, leaderboard
- `trade:execute` — place market/limit orders
- `trade:cancel` — cancel resting orders
- `wallet:write` — claim resolved positions, sell, withdraw

### Idempotency

State-changing endpoints (`POST /api/positions/claim`, `/api/positions/sell`, `/api/wallets/withdraw`) accept an `Idempotency-Key` request header. Re-submitting the same key within 24 hours returns the cached response instead of re-executing the action. Agents should generate a fresh UUID per logical operation and retry with the same key on transport failure.

### Rate limits

Default: 60 requests / second / IP, 500 burst. Responses include:

- `X-RateLimit-Limit`
- `X-RateLimit-Remaining`
- `X-RateLimit-Reset` (UTC unix seconds)
- `Retry-After` (seconds, on 429 / 503)

### Errors

All error responses share a stable JSON shape:

```json
{
  "error": "human readable message",
  "code": "insufficient_balance"
}
```

`code` is the machine-parseable enum. Treat it as the source of truth; the `error` string may be localized or refined over time.

### MCP server

PolyZig exposes a Model Context Protocol server at `https://api.polyzig.com/api/mcp` (Streamable HTTP transport, JSON-RPC 2.0). Connect from any MCP-compatible client (Claude Desktop, Cursor, ChatGPT) using a `pzk_*` API key as the bearer token. The MCP manifest is at `https://polyzig.com/.well-known/mcp.json`.

The MCP server returns only the tools your API key's scopes permit. As of v1 the catalogue is:

**Discovery + per-user reads (no/`read:*` scopes):**
- `get_platform_stats` — public latency + volume
- `get_user_summary` — `read:account`
- `search_markets` — `read:markets`
- `list_open_positions` — `read:positions`
- `list_paper_positions` — `read:positions`
- `list_trades` — `read:trades`

**Copy-trading reads (`read:account` / `read:trades` / `read:markets`):**
- `list_copy_configs`, `get_copy_config`
- `get_config_pnl`, `get_config_trades`
- `suggest_multiplier`

**Copy-trading writes (`trade:execute`):**
- `create_copy_config` — start mirroring a target wallet
- `start_copying`, `stop_copying` — activate/deactivate a config
- `delete_copy_config`

**Direct trading:**
- `place_market_order` — `trade:execute`
- `list_open_orders` — `read:markets`
- `cancel_order` — `trade:cancel`
- `claim_positions` — `wallet:write`

For prose covering authentication flow, idempotency semantics, pagination headers, and concrete request/response examples for the copy-trading workflow, see the agent integration guide at `https://polyzig.com/AGENTS.md`.

### Top endpoints for agents

| Method | Path | Purpose |
|---|---|---|
| GET | `/api/markets/translations?search=` | Search markets by title (paginated) |
| GET | `/api/stats/platform` | Public platform-wide latency + volume |
| GET | `/api/stats/summary` | Per-user PnL summary (auth) |
| GET | `/api/positions` | Open on-chain positions (auth) |
| GET | `/api/paper/positions` | Paper-trading positions (auth) |
| GET | `/api/trades?limit=50` | Trade history (auth) |
| GET | `/api/markets/orders` | Resting CLOB orders (auth) |
| POST | `/api/markets/order` | Place order (auth + `trade:execute`) |
| POST | `/api/positions/claim` | Redeem resolved positions (auth + `wallet:write`) |

### Public feeds

- Markets RSS: https://polyzig.com/feed/markets.xml
- Guides RSS: https://polyzig.com/feed/guides.xml
- Leaderboard JSON: https://polyzig.com/feed/leaderboard.json