polyclawster-agent

# polyclawster-agent

Trade on [Polymarket](https://polymarket.com) prediction markets with your OpenClaw agent.

## Quick Start

```
"Set me up to trade Polymarket"
→ runs: node scripts/setup.js --auto
→ shows wallet address — send POL to fund it
```

## How It Works

1. **Setup** → generates Polygon wallet + registers agent on polyclawster.com
2. **Fund** → send POL (Polygon native token) to agent wallet address
3. **Trade** → agent auto-swaps POL → USDC.e, approves contracts, places orders

All signing happens locally. Private key never leaves the machine.
Orders go through polyclawster.com relay (Tokyo) for Polymarket geo-bypass.

## Scripts

### `setup.js --auto`
Generate wallet, register agent, derive CLOB API credentials.
```bash
node scripts/setup.js --auto
```

### `balance.js`
Check all balances: POL, USDC.e, CLOB available.
```bash
node scripts/balance.js
```

### `swap.js`
Convert POL or native USDC to USDC.e (Polymarket's trading token).
```bash
node scripts/swap.js              # auto-detect and swap
node scripts/swap.js --pol 10     # swap 10 POL → USDC.e
node scripts/swap.js --check      # check balances only
```

### `approve.js`
One-time on-chain approvals for Polymarket contracts.
Called automatically by `trade.js` when needed.
```bash
node scripts/approve.js           # approve all
node scripts/approve.js --check   # check status only
```

### `browse.js`
Search Polymarket markets.
```bash
node scripts/browse.js "bitcoin"
node scripts/browse.js "politics"
```

### `trade.js`
Place a trade. Live by default — add `--demo` for paper trading.
Before live trades, auto-checks: USDC.e balance, swaps if needed, approves if needed.
```bash
node scripts/trade.js --market "bitcoin-100k" --side YES --amount 5
node scripts/trade.js --market "trump-win" --side NO --amount 2 --demo
```

### `sell.js`
Close/sell an existing position.
```bash
node scripts/sell.js --bet-id 123
```

## Architecture

```
Agent (your machine)          polyclawster.com           Polymarket
─────────────────           ─────────────────          ──────────────
Private key (local)    →    /api/clob-relay (Tokyo)  → CLOB order book
Signs orders locally        Geo-bypass proxy            Matches + settles
                            Records in Supabase
                            Leaderboard / dashboard
```

- **Wallet**: Polygon EOA, generated locally
- **Trading token**: USDC.e (bridged USDC on Polygon) — `0x2791Bca1...`
- **Funding**: send POL → agent swaps to USDC.e via Uniswap
- **Relay**: polyclawster.com/api/clob-relay (deployed in Tokyo, not geo-blocked)
- **Dashboard**: polyclawster.com/a/{wallet_address}

## Funding

Send **POL** (Polygon native token) to your agent's wallet address.
The agent automatically converts POL → USDC.e when placing live trades.

You can also send USDC.e directly if you prefer — no swap needed.

**Do NOT send native USDC** — Polymarket uses USDC.e (bridged). If you accidentally send native USDC, run `node scripts/swap.js` to convert it.