Manual Trade Placement

Place manual trades on Polymarket by telling your agent what to bet on. Supports FAK (instant fill at market) and GTC (limit order on the book). Pass a Simme...

Security Scan

The skill's behavior mostly matches a Polymarket/Simmer trading tool, but there are inconsistencies in declared requirements and the code loads a global .env file (/root/.openclaw/.env), which is unnecessary and could expose unrelated secrets — treat with caution.

Purpose & Capability

The skill's name/description (manual trading on Polymarket via Simmer) matches the code and README: it calls Simmer APIs, fetches CLOB book data, and places orders. However the registry metadata shown at the top says 'Required env vars: none' and 'Primary credential: none' while clawhub.json, README.md, and SKILL.md all declare SIMMER_API_KEY and WALLET_PRIVATE_KEY as required; this mismatch is an incoherence that should be resolved before trusting the skill.

Instruction Scope

SKILL.md and manual_trade.py instruct the agent to import markets, fetch live order book data, and place signed trades via simmer-sdk — all expected. But manual_trade.py unconditionally attempts to load a .env file at /root/.openclaw/.env using dotenv.load_dotenv("/root/.openclaw/.env"). Loading an agent-global .env file is unnecessary for the skill's stated usage and risks reading unrelated secrets stored there. The code otherwise calls only expected external endpoints (api.simmer.markets, clob.polymarket.com).

Install Mechanism

This is instruction-only with a shipped Python script; there is no install spec. clawhub.json lists a pip requirement (simmer-sdk). No external arbitrary downloads or archive extraction are present. The absence of a formal install step is low risk, but the skill will require installing simmer-sdk to operate.

Credentials

Requiring SIMMER_API_KEY and WALLET_PRIVATE_KEY is proportionate to placing signed trades, but these are highly sensitive. The code doesn't directly reference WALLET_PRIVATE_KEY but relies on simmer-sdk (which may read env vars or accept a key) — that is reasonable but sensitive. The bigger proportionality concern is the unconditional load of /root/.openclaw/.env, which may grant the skill access to additional secrets beyond the two declared variables. Also the registry metadata inconsistency (required envs omitted at the top) is a red flag.

Persistence & Privilege

always: false and no autostart/always flags are set. The skill does not request system-wide persistence or modify other skills' configurations. Note: the skill can be invoked autonomously by default (platform normal behavior) — combined with access to a private wallet key this increases blast radius, so only grant credentials to trusted skills.

What to consider before installing

This skill appears to implement Polymarket trades via Simmer and legitimately needs SIMMER_API_KEY and your wallet key, but there are two red flags: (1) the package/registry metadata omitted required env vars while the included files declare SIMMER_API_KEY and WALLET_PRIVATE_KEY — confirm which is accurate before proceeding; (2) manual_trade.py calls dotenv.load_dotenv('/root/.openclaw/.env'), which will read an agent-global .env file and could expose unrelated secrets. Before installing or providing credentials: review the code yourself (or ask the author) and remove the load_dotenv call, run the skill in a sandboxed environment, only provide a wallet key you can rotate or a test wallet, or prefer using the 'sim' venue for testing. If you don't trust the author or can't inspect/modify the code, do not provide your WALLET_PRIVATE_KEY to this skill.

Place trades on Polymarket by telling your AI agent what to bet on. Supports instant FAK fills and GTC limit orders. Works with Simmer market IDs or full Polymarket event URLs.

Usage

Tell your agent:

"Buy YES $10 on [Polymarket URL or market ID]" "Place a GTC limit NO $20 at 0.35 on [market]"

Or run directly:

# FAK — instant fill at best ask price (default)
python3 manual_trade.py --market <market_id_or_url> --side YES --amount 10

# GTC — limit order, sits on book until filled
python3 manual_trade.py --market <market_id_or_url> --side NO --amount 20 --order GTC --price 0.35

# Full Polymarket URL — auto-imports and trades
python3 manual_trade.py \
  --market https://polymarket.com/event/spacex-starship-flight-test-12/will-the-chopsticks-catch-spacex-starship-flight-test-12-superheavy-booster \
  --side YES --amount 10

# Dry run (preview without placing)
python3 manual_trade.py --market <id> --side YES --amount 10 --dry-run

Order Types

Type	Behavior	When to use
FAK (default)	Fills immediately at best ask+0.01. Remainder cancelled.	You want in now at market price
GTC	Limit order sits on CLOB book. Funds locked on placement, fill when market reaches your price	You want a specific price

Arguments

Flag	Description
--market / -m	Simmer market ID or full Polymarket URL
--side / -s	YES or NO
--amount / -a	Dollar amount (default $10)
--order / -o	FAK, GTC, or FOK (default FAK)
--price / -p	Limit price (optional — auto-fetches best ask+0.01 if omitted)
--venue / -v	polymarket or sim (default polymarket)
--cancel	Cancel all open orders on the market
--cancel-side	Cancel only yes or no side orders
--dry-run	Preview without placing

How it Works

1. Market resolution — if you pass a Polymarket URL, it auto-imports via Simmer's import API and resolves to the correct market
2. Price discovery — fetches live CLOB order book, uses best ask + 0.01 for FAK to guarantee fill
3. Order placement — signs and submits via simmer-sdk with your wallet key
4. Confirmation — reports shares filled, cost, and trade ID

Requirements

• SIMMER_API_KEY — your Simmer API key
• WALLET_PRIVATE_KEY — your Polymarket wallet private key (for on-chain signing)
• simmer-sdk >= 0.8.32

---

Built for Simmer — the AI trading agent platform for Polymarket and Kalshi.