← Back to Skills Marketplace
chasewebb

Polymarket Fee Aware Divergence

by Chase Webb · GitHub ↗ · v0.1.0 · MIT-0
cross-platform ⚠ suspicious
44
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install polymarket-fee-aware-divergence
Description
Trades AI-vs-market divergence on Polymarket only when the gap clears fees, spread, and a configurable safety margin. Skips every trade where the math doesn'...
Usage Guidance
Before installing or enabling this skill: - Confirm that SIMMER_API_KEY is the only credential you intend to grant; this API key lets the skill list markets and place trades. Treat it like a trading key and limit privileges where possible. - The package declares a pip dependency (simmer-sdk) but provides no install step; ensure the environment installs simmer-sdk (pip install simmer-sdk) or the skill will fail to run. - The clawhub.json lists WALLET_PRIVATE_KEY as optional, but the code doesn't use it; ask the author whether external-wallet functionality exists and whether providing a private key is necessary (avoid giving private keys unless absolutely required and reviewed). - The skill will include the divergence math and AI consensus in the public trade 'reasoning' field and logs — if that data is sensitive, do not enable public trade posting. - There are minor bugs/rough edges in the code (e.g., format_reason references an undefined variable which could crash or garble logged reasons); test thoroughly on TRADING_VENUE=sim and run many paper trades as recommended before enabling live funds. - Because the skill can autonomously run on a cron, limit MAX_TRADES and run in paper mode until you are confident in behavior. Rotate credentials after testing if they were exposed in logs. If you want, provide the runtime environment details (whether pip packages are auto-installed by the platform) and I can re-evaluate with higher confidence.
Capability Analysis
Type: OpenClaw Skill Name: polymarket-fee-aware-divergence Version: 0.1.0 The skill implements a legitimate fee-aware trading strategy for Polymarket as described in its documentation. The Python script (fee_aware_divergence.py) uses the simmer-sdk to fetch market data and execute trades based on a calculated edge that accounts for fees and spreads. There is no evidence of data exfiltration, malicious execution, or prompt injection; the environment variables requested in clawhub.json are standard for automated trading applications.
Capability Tags
cryptorequires-walletrequires-sensitive-credentials
Capability Assessment
Purpose & Capability
The code implements AI-vs-market divergence trading on Polymarket-imported markets and uses a SimmerClient to list markets and place trades — this matches the skill description. Declared primaryEnv (SIMMER_API_KEY) is appropriate for the Simmer SDK. Minor mismatch: the top-level registry metadata in the report said "Required env vars: none", but clawhub.json and the code require SIMMER_API_KEY.
Instruction Scope
SKILL.md and the code restrict actions to fetching markets, evaluating simple math (ai_consensus, price, fees, spread), and calling the Simmer SDK trade API. The instructions do not attempt to read arbitrary system files or unrelated environment variables. Note: every placed trade includes a human-readable reasoning string which will be visible in the public trades tab and logs (possible information disclosure of AI consensus and internal math).
Install Mechanism
The repository is instruction-only (no platform install spec), but clawhub.json declares a pip requirement for 'simmer-sdk'. The runtime will sys.exit if simmer-sdk is not installed. Because there is no install mechanism included, the platform/operator must ensure simmer-sdk is present — this mismatch can cause runtime failure and suggests incomplete packaging.
Credentials
SIMMER_API_KEY is declared and used — appropriate. However: clawhub.json documents an optional WALLET_PRIVATE_KEY (only needed for external-wallet self-custody trading) but the Python code does not reference WALLET_PRIVATE_KEY — this is an unexplained declaration. The code also reads FAD_VERBOSE (env) for verbosity, but that variable is not declared in clawhub.json or SKILL.md. These inconsistencies are proportionally small but worth clarifying. Also be aware that providing SIMMER_API_KEY grants the skill the ability to place trades via the Simmer API.
Persistence & Privilege
always:false (not force-included); automaton.managed true with a cron schedule (*/30 * * * *) is reasonable for a trading bot. The skill does not modify other skills or system-wide settings. Autonomous invocation will allow periodic trading — a normal platform capability but a real financial risk if misconfigured.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install polymarket-fee-aware-divergence
  3. After installation, invoke the skill by name or use /polymarket-fee-aware-divergence
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.0
- Initial release of polymarket-fee-aware-divergence. - Only trades AI-market divergences that clear all costs: fees, spread, and a configurable safety margin. - Restricts trades to Polymarket-imported markets resolving in 30 min–12 hours. - Skips trades when costs or market conditions (e.g., wide spread, active position, or high slippage) make a positive net edge impossible. - Adds config options for trade size, required edge, safety margin, max spread, time-to-resolution window, and venue. - Each trade includes a clear reasoning string with divergence, fee, spread, and net edge calculations for transparency.
Metadata
Slug polymarket-fee-aware-divergence
Version 0.1.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Polymarket Fee Aware Divergence?

Trades AI-vs-market divergence on Polymarket only when the gap clears fees, spread, and a configurable safety margin. Skips every trade where the math doesn'... It is an AI Agent Skill for Claude Code / OpenClaw, with 44 downloads so far.

How do I install Polymarket Fee Aware Divergence?

Run "/install polymarket-fee-aware-divergence" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Polymarket Fee Aware Divergence free?

Yes, Polymarket Fee Aware Divergence is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Polymarket Fee Aware Divergence support?

Polymarket Fee Aware Divergence is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Polymarket Fee Aware Divergence?

It is built and maintained by Chase Webb (@chasewebb); the current version is v0.1.0.

💬 Comments