← Back to Skills Marketplace
2090
Downloads
3
Stars
16
Active Installs
24
Versions
Install in OpenClaw
/install polymarket-ai-divergence
Description
Find markets where Simmer's AI consensus diverges from the real market price, then trade on the mispriced side using Kelly sizing. Scans for divergence, chec...
Usage Guidance
This skill appears to implement a legitimate divergence scanner + trading bot, but review carefully before enabling live trading. Key points:
- Only provide SIMMER_API_KEY and especially WALLET_PRIVATE_KEY if you trust the Simmer SDK and this skill — the wallet private key grants control to sign trades and potentially move funds.
- Prefer using a managed custody wallet (if supported) or a wallet with limited funds; avoid exposing a long-term hot key with large balances.
- There are inconsistencies between the README, the Python code, and clawhub.json (env var names and default values). Double-check which environment variable names the running code actually reads (see CONFIG_SCHEMA in ai_divergence.py) to avoid misconfiguration.
- Run the skill in dry-run (--no-live) or paper mode first and inspect generated trade payloads, and inspect the simmer-sdk version you will install (simmer-sdk>=0.11.1). Consider reviewing the Simmer SDK source for how it uses WALLET_PRIVATE_KEY and whether it forwards secrets to external services.
- If you are not comfortable storing private keys in env vars, use managed wallets or decline live trading and use the scanner only.
Capability Analysis
Type: OpenClaw Skill
Name: polymarket-ai-divergence
Version: 2.3.0
The skill bundle is a legitimate trading bot template for the Polymarket prediction market, utilizing the Simmer SDK. The code in ai_divergence.py implements a standard quantitative trading strategy (Kelly sizing based on AI divergence) and includes appropriate safeguards such as daily budget limits and fee checks. While the skill requires sensitive information like a WALLET_PRIVATE_KEY, this is explicitly disclosed in SKILL.md as necessary for live trading, and the code does not show any signs of exfiltrating this key or performing unauthorized actions. The auxiliary files, gamma_api.py and scripts/status.py, provide standard market research and monitoring capabilities without any suspicious logic.
Capability Tags
Capability Assessment
Purpose & Capability
Name/description, code files, and API endpoints align with a Polymarket/Simmer divergence scanner + trading bot. The included Gamma API client and status script are consistent with the stated purpose.
Instruction Scope
SKILL.md instructs installing simmer-sdk, storing SIMMER_API_KEY and (for live trading) WALLET_PRIVATE_KEY in the environment. The skill will call Simmer API endpoints and the Polymarket Gamma API. However the documentation, the code, and clawhub.json disagree on several env var names and default values (e.g., SIMMER_DIVERGENCE_MAX_BET vs SIMMER_DIVERGENCE_MAX_BET_USD, differing defaults for max bet/daily budget), which can cause misconfiguration. Asking the user to store a private key in an env var is within scope for a trading bot but is a sensitive action that requires explicit user consent and understanding.
Install Mechanism
No arbitrary download URLs or extract steps. The package depends on simmer-sdk (pip). The skill is provided as code files rather than a binary install; pip installing simmer-sdk is a typical moderate-risk dependency for this use case.
Credentials
Primary credential SIMMER_API_KEY is appropriate. The optional WALLET_PRIVATE_KEY is sensitive but plausible for self-custody live trading. The SKILL.md encourages storing a private key in an environment variable (WALLET_PRIVATE_KEY) while the code itself delegates signing to the simmer-sdk; this is proportional to trading but represents a high-value secret — users should not provide it unless they trust the SDK and skill. There are also minor env-name mismatches between docs, code, and clawhub.json that could cause accidental misconfiguration and unexpected behavior.
Persistence & Privilege
The skill is not always-enabled and autostart is false. clawhub.json marks the skill as automaton.managed with an entrypoint (ai_divergence.py), meaning the platform may run it on a schedule; this is expected for trading automation but increases blast radius if credentials are supplied. No code modifies other skills or system-wide settings.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install polymarket-ai-divergence - After installation, invoke the skill by name or use
/polymarket-ai-divergence - Provide required inputs per the skill's parameter spec and get structured output
Version History
v2.3.0
Migrate to Polymarket Gamma keyset pagination (deprecation deadline May 1, 2026). GammaClient.get_markets and get_events now return (list, next_cursor); get_market and get_event use keyset filter form. search() unchanged.
v2.2.9
polymarket-ai-divergence v2.2.9
- Updated metadata version in SKILL.md to 2.2.9
- No user-facing feature changes or command updates
- Maintenance release for version consistency
v2.2.8
Schema fix: primaryEnv + envVars with required:false for optional credentials. Clears OpenClaw 'disproportionate requirements' verdict.
v2.2.7
Declare WALLET_PRIVATE_KEY in requires.env for OpenClaw moderation alignment.
v2.2.6
Add Setup Flow section with pip install simmer-sdk
v2.2.5
Inline gamma_api helper (was simmer_sdk.gamma_api before SDK 0.9.21 removed it). No behavior change.
v2.2.4
Add auto_redeem() call at start of each cycle for external wallet support
v2.2.3
- Updated internal logic in `ai_divergence.py` (implementation change; no user-facing configuration or documentation changes).
- No updates to documentation or configuration in this version.
v2.2.2
- Internal updates to ai_divergence.py with no user-facing changes.
- SKILL version unchanged (remains at 2.2.0).
- No updates to documentation or configuration.
v2.2.1
## v2.2.1 Changelog
- Internal update to `ai_divergence.py`.
- No changes to documentation or configuration.
- No user-facing features or interface modifications.
v2.2.0
- Bumped version to 2.2.0
- Updated SKILL.md metadata and version references
- No user-facing behavioral changes detected in public documentation
v2.1.1
Fix env var drift: align CONFIG_SCHEMA with clawhub.json tunables for autotune compatibility
v2.1.0
Rename venue simmer to sim
v2.0.7
AgentSkills format — moved platform config to clawhub.json for cross-agent compatibility
v2.0.6
- Added "difficulty: intermediate" to the SKILL.md metadata.
- No core logic or functionality changes; documentation update only.
v2.0.5
No changes detected in this version (2.0.5).
- No file changes or feature updates were made.
- All functionality and documentation remain the same as the previous version.
v2.0.4
- Updated internal logic in `ai_divergence.py`.
- No changes to user-facing documentation or configuration.
- No API changes or new features introduced in this version.
v2.0.3
Add is_live_now field to Market dataclass; forward-compatible filter to skip not-yet-open markets
v2.0.2
No file changes were detected in this version.
- Version bump to 2.0.2 with no code or documentation changes.
- No user-facing functionality added, removed, or altered.
v2.0.1
- Updated SKILL.md to clarify that Simmer's AI consensus price is derived from multi-model ensemble forecasting.
- No changes to core logic or functionality—documentation update only.
Metadata
Frequently Asked Questions
What is Polymarket Ai Divergence?
Find markets where Simmer's AI consensus diverges from the real market price, then trade on the mispriced side using Kelly sizing. Scans for divergence, chec... It is an AI Agent Skill for Claude Code / OpenClaw, with 2090 downloads so far.
How do I install Polymarket Ai Divergence?
Run "/install polymarket-ai-divergence" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Polymarket Ai Divergence free?
Yes, Polymarket Ai Divergence is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Polymarket Ai Divergence support?
Polymarket Ai Divergence is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Polymarket Ai Divergence?
It is built and maintained by AD88 (@adlai88); the current version is v2.3.0.
More Skills