← Back to Skills Marketplace
442
Downloads
2
Stars
4
Active Installs
3
Versions
Install in OpenClaw
/install polymarket-trade-agent
Description
Trade on Polymarket by researching markets, analyzing event probabilities, managing USDC balance, and executing buy/sell orders with risk-controlled position...
Usage Guidance
This package implements a real trading client but asks you to provide your Polygon (Ethereum-style) private key — which gives full control over any funds in that wallet. Before installing or running it:
- Only use a wallet/private key you control and which contains minimal funds for testing (preferably a throwaway or test account). Never use your main funds/private key.
- Verify the source: the registry metadata and SKILL.md disagree about required env vars. Confirm the publisher and review the py-clob-client dependency and its trustworthiness.
- Consider running the code in an isolated environment (VM or container) and inspect the code yourself; the files here are readable and show the network endpoints used (clob.polymarket.com and data-api.polymarket.com).
- Note the SKILL.md guidance to export the raw private key from MetaMask is inherently risky — follow wallet best practices (use hardware wallets or signing-only flows where possible). If you must use an env var key, keep it in a restricted environment and rotate it afterward.
- Test read-only commands (address, markets, balance) first. Be cautious with buy/sell: start with tiny trades and confirm behavior.
If you want higher assurance, ask the publisher for provenance (homepage, source repo, or signed release) and a clear manifest of required environment variables and optional settings. If you cannot verify the author, treat the skill as high risk and avoid supplying a primary private key.
Capability Analysis
Type: OpenClaw Skill
Name: polymarket-trade-agent
Version: 1.0.1
The OpenClaw skill bundle implements a Polymarket trading agent. It requires the user to provide a `POLYMARKET_PRIVATE_KEY` for its functionality, which is a highly sensitive credential. However, the code uses this key solely for its stated purpose of interacting with legitimate Polymarket APIs (`data-api.polymarket.com`, `clob.polymarket.com`) for balance checks, market data, and order placement, as seen in `trade.py`. There is no evidence of data exfiltration to unauthorized third parties, persistence mechanisms, or other malicious activities. The `SKILL.md` instructions are clear, directly related to the agent's purpose, and do not contain any prompt injection attempts to mislead the AI agent.
Capability Assessment
Purpose & Capability
The code and instructions match the stated purpose (research markets, check balance, place orders) and include expected dependencies (py-clob-client, web3, eth-account). However the registry metadata declares no required environment variables while SKILL.md and the code clearly require POLYMARKET_PRIVATE_KEY (and optionally POLYMARKET_FUNDER_ADDRESS), which is an inconsistency in the package metadata.
Instruction Scope
SKILL.md directs the user to export a raw private key from MetaMask and set POLYMARKET_PRIVATE_KEY in the environment — a highly sensitive operation. The CLI and trade.py use that key to derive API credentials and interact with Polymarket endpoints (clob.polymarket.com and data-api.polymarket.com), which is coherent with the purpose but risky. Additionally, SKILL.md labels POLYMARKET_FUNDER_ADDRESS as optional, yet trade.get_positions requires it and will raise an error; this mismatch can cause runtime failures.
Install Mechanism
No install script or remote downloads are present; the package is instruction-and-code only and lists dependencies in requirements/pyproject. No extract-from-URL or third-party installers were specified.
Credentials
Requesting the wallet private key is proportionate to an agent that must sign transactions, but it is a high-privilege secret and must be handled carefully. The code also reads POLYMARKET_SIGNATURE_TYPE (not documented in SKILL.md) and treats POLYMARKET_FUNDER_ADDRESS inconsistently. The metadata omission of required env vars increases risk because the platform-level manifest does not surface the sensitive requirement.
Persistence & Privilege
The skill does not request always:true, does not modify other skills, and has no install-time hooks that persist beyond the usual package footprint. Autonomous invocation is allowed (platform default) but not combined with other privilege-escalating flags.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install polymarket-trade-agent - After installation, invoke the skill by name or use
/polymarket-trade-agent - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.1
Polymarket Trade Agent Skill v1.0.1
- Added _meta.json file for additional skill metadata.
- Updated trade.py (details not specified).
- No changes to user commands or documentation.
- Minor internal updates; all existing features and setup remain unchanged.
v1.0.0
Initial release — introduces a Polymarket trading agent.
- Enables researching markets, analyzing opportunities, and executing trades on Polymarket.
- Supports wallet configuration, USDC balance checks, and both buy/sell functions.
- Provides commands for market research, trading, and utility tasks.
- Includes guidance on trading strategy, position sizing, and risk management.
v0.1.0
Initial release with trading functionality
Metadata
Frequently Asked Questions
What is Polymarket Trade Agent?
Trade on Polymarket by researching markets, analyzing event probabilities, managing USDC balance, and executing buy/sell orders with risk-controlled position... It is an AI Agent Skill for Claude Code / OpenClaw, with 442 downloads so far.
How do I install Polymarket Trade Agent?
Run "/install polymarket-trade-agent" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Polymarket Trade Agent free?
Yes, Polymarket Trade Agent is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Polymarket Trade Agent support?
Polymarket Trade Agent is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Polymarket Trade Agent?
It is built and maintained by Han Wu (@hanswuhan); the current version is v1.0.1.
More Skills