← 返回 Skills 市场
richducat

Polymarket Clob Microstructure

作者 richducat · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ⚠ suspicious
84
总下载
0
收藏
0
当前安装
1
版本数
在 OpenClaw 中安装
/install dolph-clob-microstructure
功能描述
Analyzes Polymarket order book microstructure for inefficiencies and generates signals to trade fake breakouts and manage position sizing.
使用说明 (SKILL.md)

CLOB Microstructure Scanner

Structural alpha from Polymarket order book analysis. Nobody else on Simmer does this.

What It Does

Pulls raw order book data from Polymarket's CLOB API and scores each market on four microstructure dimensions:

Dimension What It Measures
Liquidity Gaps Thin zones in the book where price can jump
Order Book Imbalance Bid vs ask weight asymmetry
Whale Activity Large single orders relative to book depth
Fake Breakout Detection Sudden moves on thin volume that revert

Each dimension scores 0-25, combined into a 0-100 inefficiency score.

Signals

  • ENTRY_OK — Normal conditions, standard sizing
  • REDUCE_SIZE — Elevated microstructure risk, cut position size
  • SKIP — Too dangerous, stay out
  • MEAN_REVERT — Fake breakout detected, fade the move

The bot only trades on MEAN_REVERT signals, fading fake breakouts via SimmerClient.

Configuration

  • Runs every 5 minutes via cron
  • Defaults to dry-run; pass --live for real execution
  • Requires SIMMER_API_KEY environment variable

Usage

# Dry run (default)
python clob_microstructure.py

# Live trading
python clob_microstructure.py --live

# Quiet mode for cron
python clob_microstructure.py --live --quiet

🧪 Remixable Template — Fork this skill and tweak the scoring weights, signal thresholds, or add your own microstructure indicators. The modular scoring system makes it easy to extend.

安全使用建议
This skill appears to do what it claims (analyze order books and optionally trade) but there are important practical risks and metadata inconsistencies to consider before installing: - Metadata mismatch: the registry summary that listed no required env vars is incorrect; SKILL.md and clawhub.json require SIMMER_API_KEY. Treat the latter as authoritative. Ask the publisher to correct registry metadata before trusting the package. - Trading risk: with a valid SIMMER_API_KEY and running the script with --live, the skill will place real trades. Keep the API key scoped to minimal permissions and test thoroughly in dry-run mode first. - Autonomy & scheduling: the skill is intended to run on a 5-minute cron. If you allow autonomous invocation or enable scheduled runs, ensure you have monitoring and limits (MAX_TRADES_PER_RUN, position caps) configured and that you understand how to abort live runs. - Hidden env usage: the code reads several optional CLOB_* environment variables not declared in the registry; audit any environment variables you set and review the code (including the truncated portion) to ensure there are no unexpected network endpoints or exfiltration paths. - Code review: before providing credentials, review the full Python file (the sample was truncated) for any unexpected network calls, logging of secrets, or code paths that could post data to unknown endpoints. If you want to proceed: run in dry-run mode locally, confirm behavior, and limit the SIMMER_API_KEY permissions and schedule. If you prefer, ask the publisher to provide corrected metadata and a third-party security review.
功能分析
Type: OpenClaw Skill Name: dolph-clob-microstructure Version: 1.0.0 The skill is a legitimate trading bot designed to analyze Polymarket order book microstructure and execute trades via the Simmer SDK. It fetches market data from official Polymarket API endpoints (clob.polymarket.com and data-api.polymarket.com) and implements transparent scoring logic for liquidity gaps, imbalances, and whale activity. No evidence of data exfiltration, malicious execution, or prompt injection was found in clob_microstructure.py or SKILL.md.
能力标签
crypto
能力评估
Purpose & Capability
The skill's name, description, SKILL.md and clob_microstructure.py align: it fetches Polymarket order books, scores microstructure, and can trade MEAN_REVERT signals via SimmerClient. However the registry summary at the top of the prompt claimed no required environment variables while both SKILL.md and clawhub.json require SIMMER_API_KEY — a discrepancy in metadata that should be corrected. Requesting an API key for Simmer is appropriate for trading functionality.
Instruction Scope
SKILL.md instructs running clob_microstructure.py (cron every 5 minutes) and explicitly supports a --live mode to execute real trades; the script uses network calls to clob.polymarket.com and data-api.polymarket.com and invokes SimmerClient to place trades. The instructions and code permit autonomous periodic execution and live trading if the API key is present. The SKILL.md claims defaults to dry-run but gives the agent clear means to execute real trades — this increases risk if the skill is invoked without careful review.
Install Mechanism
There is no installer that downloads arbitrary code; the package is instruction-only with an included Python file. clawhub.json declares pip dependencies (simmer-sdk, requests) which are reasonable for the stated purpose. No external or untrusted download URLs are present.
Credentials
The skill requires SIMMER_API_KEY (declared in SKILL.md and clawhub.json) which is appropriate for trading, but the top-level manifest reported 'Required env vars: none' — inconsistent metadata. The code also reads many optional CLOB_* and TRADING_VENUE environment variables (CLOB_LIQUIDITY_GAP, CLOB_IMBALANCE_THRESHOLD, CLOB_TRADE_SIZE, CLOB_MARKETS_TO_SCAN, CLOB_MIN_HOURS_TO_EXPIRY, CLOB_MAX_TRADES, etc.) that are not declared in the registry env list. Because this skill can perform actions with financial impact, ensure the SIMMER_API_KEY has limited permissions and that you understand how live mode is triggered.
Persistence & Privilege
always:false (not force-installed) and model invocation is allowed (normal). The skill can be scheduled (cron every 5 minutes) and, when invoked with --live and provided credentials, will place trades. Autonomous invocation combined with real-trade capability raises the operational risk (unexpected trades) but is not in itself a manifest privilege escalation—review invocation policies and restrict automatic runs if needed.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install dolph-clob-microstructure
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /dolph-clob-microstructure 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.0
- Initial release of CLOB Microstructure Scanner for Polymarket order book analysis - Scores markets on liquidity gaps, order book imbalance, whale activity, and fake breakout detection (0–100 scale) - Generates actionable trading signals: ENTRY_OK, REDUCE_SIZE, SKIP, and MEAN_REVERT - Trades only on MEAN_REVERT signals, fading fake breakouts for structural alpha - Modular, extensible scoring system; runs every 5 minutes by default - Supports dry-run and live-trading modes
元数据
Slug dolph-clob-microstructure
版本 1.0.0
许可证 MIT-0
累计安装 0
当前安装数 0
历史版本数 1
常见问题

Polymarket Clob Microstructure 是什么?

Analyzes Polymarket order book microstructure for inefficiencies and generates signals to trade fake breakouts and manage position sizing. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 84 次。

如何安装 Polymarket Clob Microstructure?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install dolph-clob-microstructure」即可一键安装,无需额外配置。

Polymarket Clob Microstructure 是免费的吗?

是的,Polymarket Clob Microstructure 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。

Polymarket Clob Microstructure 支持哪些平台?

Polymarket Clob Microstructure 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 Polymarket Clob Microstructure?

由 richducat(@richducat)开发并维护,当前版本 v1.0.0。

💬 留言讨论