← Back to Skills Marketplace
Polymarket Trader
by
Abdulaleem Zakariyah
· GitHub ↗
· v1.0.1
462
Downloads
0
Stars
1
Active Installs
2
Versions
Install in OpenClaw
/install zakkycrypt01-polymarket-trader
Description
Execute limit orders on Polymarket markets by specifying market slug, outcome, price, and order size via a Python script.
Usage Guidance
Before installing or using this skill: 1) Do not set your POLYMARKET_PRIVATE_KEY in any environment you don't fully control — treat it like any other wallet/private key. 2) Verify the py-clob-client package provenance (source, releases) before installing into the required virtualenv. 3) The registry metadata omits the POLYMARKET_PRIVATE_KEY requirement — ask the publisher to correct that or avoid relying on the skill until it's fixed. 4) Run the included trade.py in an isolated/test account first to confirm behavior; inspect what create_or_derive_api_creds() from py_clob_client does (it may create/derive additional credentials). 5) If you must use this, create a dedicated sandboxed workspace and virtualenv at the expected path, and do not store your private key in shared or persistent CI/agent environments. If you are uncomfortable with these checks or cannot review py-clob-client source, do not install or run this skill.
Capability Analysis
Type: OpenClaw Skill
Name: zakkycrypt01-polymarket-trader
Version: 1.0.1
The skill is designed to securely execute trades on Polymarket. It correctly handles the `POLYMARKET_PRIVATE_KEY` by reading it from an environment variable and uses it solely for authenticating with the Polymarket CLOB client. The `SKILL.md` explicitly states that arguments are passed via environment variables to `trade.py` to prevent shell injection, demonstrating a focus on security. All network calls are directed to legitimate Polymarket API endpoints (`gamma-api.polymarket.com`, `clob.polymarket.com`), which is expected for its functionality. The `inspect_client.py` and `inspect_methods.py` files are benign utility scripts for library introspection, not used in the main skill execution, and pose no security risk. There is no evidence of data exfiltration, malicious execution, persistence mechanisms, or prompt injection attempts against the agent.
Capability Assessment
Purpose & Capability
The skill's stated purpose (placing Polymarket limit orders) matches the included trade.py which calls Polymarket APIs and uses a private key. However the registry metadata claims no required credentials while both SKILL.md and trade.py clearly require POLYMARKET_PRIVATE_KEY, an inconsistency between claimed requirements and actual needs.
Instruction Scope
SKILL.md and the tool exec are narrowly scoped to: activate a virtualenv, export MARKET_SLUG/DIRECTION/PRICE/SIZE, and run trade.py. The runtime actions (fetch public market data, build and post an order via py_clob_client) align with the purpose. Minor issues: the exec command depends on a specific relative path (../../polymarket_venv) and SKILL.md's security claim ('prevents shell injection') is overstated because it assumes the environment and substitution are handled safely by the host; the exec chain does not explicitly surface the required POLYMARKET_PRIVATE_KEY.
Install Mechanism
There is no install spec (instruction-only), which reduces installer risk, but SKILL.md requires a Python virtualenv at a specific relative path with packages ('py-clob-client', 'requests') installed. The skill does not provide automated installation or verify package provenance; manually creating the venv and installing py-clob-client (an external package) is required and should be done from trusted sources.
Credentials
trade.py requires a sensitive environment variable POLYMARKET_PRIVATE_KEY to sign and derive API credentials. Requesting a private key is proportionate for a trading skill, but the registry metadata failing to declare this sensitive requirement is a significant omission. Additionally, the activation of a venv via a relative path that reaches up directories (../../polymarket_venv) could cause unexpected access to workspace files if the environment is not tightly controlled.
Persistence & Privilege
The skill is not marked always:true and does not request persistent system-wide privileges or modify other skills; autonomous invocation is allowed by default but not combined with other high-risk factors here.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install zakkycrypt01-polymarket-trader - After installation, invoke the skill by name or use
/zakkycrypt01-polymarket-trader - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.1
Version 1.0.1: Patched critical shell injection vulnerability.
v1.0.0
Initial release of the Polymarket trading skill.
Metadata
Frequently Asked Questions
What is Polymarket Trader?
Execute limit orders on Polymarket markets by specifying market slug, outcome, price, and order size via a Python script. It is an AI Agent Skill for Claude Code / OpenClaw, with 462 downloads so far.
How do I install Polymarket Trader?
Run "/install zakkycrypt01-polymarket-trader" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Polymarket Trader free?
Yes, Polymarket Trader is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Polymarket Trader support?
Polymarket Trader is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Polymarket Trader?
It is built and maintained by Abdulaleem Zakariyah (@zakkycrypt01); the current version is v1.0.1.
More Skills