A comprehensive command-line interface for interacting with Polymarket prediction markets, enabling AI agents to query data and manage trades.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install polymarket-cli
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install polymarket-cli using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Polymarket CLI?
The Polymarket CLI is a robust tool designed to provide AI agents with direct access to decentralized prediction markets. As a key component of the Openclaw Skills ecosystem, it allows for seamless interaction with the Polymarket Central Limit Order Book (CLOB) and Gamma API. This skill enables agents to bridge the gap between real-world event data and on-chain execution, making it an essential utility for developers building automated trading or research agents.
By leveraging this skill, users can transform their AI agents into sophisticated market analysts. The CLI is architected with a security-first approach, ensuring that sensitive wallet operations remain under user control while providing the agent with powerful read-only capabilities for market monitoring. This balance makes it one of the most practical Openclaw Skills for those engaged in the burgeoning field of prediction-based finance.
Polymarket CLI Use Cases
- Monitoring real-time odds and market sentiment for global events via Openclaw Skills.
- Automated tracking of current positions and portfolio value across multiple markets.
- Programmatic execution of trades based on specific market triggers or price movements.
- Researching market depth and order book spreads to optimize entry and exit points.
- Exporting structured market data into JSON format for advanced data analysis or reporting.
How Polymarket CLI Works
- The user installs the polymarket binary and configures it within the Openclaw Skills environment.
- The agent uses read-only commands to fetch market lists, event details, and token IDs from Polymarket APIs.
- Market data is processed using the -o json flag to ensure the agent receives structured, actionable information.
- When a trade is required, the agent identifies the specific token ID and verifies the current spread and midpoint price.
- If an order is requested, the agent prepares the command, which the user then confirms for execution on the Polygon blockchain.
Polymarket CLI Setup
To integrate this into your collection of Openclaw Skills, install the CLI using Homebrew or Cargo:
# Install via Homebrew
brew tap Polymarket/polymarket-cli
brew install polymarket
# Or install via Cargo
cargo install polymarket-cli
Once installed, you must manually configure your wallet using polymarket wallet import or create. Note that the agent is restricted from accessing your private keys directly for security.
Polymarket CLI Data Schema & Taxonomy
This skill utilizes a specific directory structure to manage configuration and persistence within Openclaw Skills:
| Location | File | Purpose |
|---|---|---|
~/.config/polymarket/ |
config.json |
Stores sensitive wallet configuration and chain settings. |
~/polymarket-cli/ |
memory.md |
Persistent storage for user preferences and tracked markets. |
~/polymarket-cli/ |
memory-template.md |
Template for structuring the agent's long-term market memory. |
All data exchanged with the Polymarket APIs can be formatted as JSON to maintain high data integrity for agent processing.
Polymarket CLI Advanced Features
- Support for complex on-chain operations including Conditional Token Framework (CTF) splitting and merging.
- Granular market filtering using limit and offset parameters for large-scale data retrieval.
- Secure execution model where high-risk wallet commands are reserved for direct user input.
- Real-time order book analysis including bid/ask spreads and midpoint price calculations within Openclaw Skills.
- Seamless integration with Polygon RPCs for direct blockchain transaction broadcasting.
SKILL.md
Loading
Related Openclaw Skills
Polygon
A specialized skill for managing transactions, bridging assets, and navigating the nuances of Polygon PoS and zkEVM networks.
Polkadot
A comprehensive assistant for managing Polkadot ecosystem interactions, from DOT staking to cross-chain transfers.
Polish
Transform robotic AI translations into natural, human-sounding Polish conversations and content.
Podcasts
A smart podcast management skill for tracking subscriptions, generating AI-powered briefings, and optimizing your listening queue.
Portugal
An AI-powered local guide to Portugal that prioritizes authentic experiences, regional expertise, and avoiding tourist traps.
Portuguese Natural Language Writing
An AI agent skill designed to replace robotic, formal Portuguese with authentic, regional, and human-sounding conversational language.
Featured*
