← Back to Skills Marketplace
hanswuhan

Polymarket Trade Agent

by Han Wu · GitHub ↗ · v1.0.1
cross-platform ⚠ suspicious
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
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install polymarket-trade-agent
  3. After installation, invoke the skill by name or use /polymarket-trade-agent
  4. 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
Slug polymarket-trade-agent
Version 1.0.1
License
All-time Installs 4
Active Installs 4
Total Versions 3
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.

💬 Comments