rey-polymarket-trader

What This Skill Does

The rey-polymarket-trader skill enables OpenClaw to interact directly with the Polymarket prediction market on the Polygon blockchain. It empowers the AI to browse live markets, search for events using keywords, and filter by categories to find trading opportunities. Beyond simple browsing, the skill implements a sophisticated Split+CLOB trading strategy, which involves splitting USDC.e into YES/NO token pairs via the Conditional Token Framework (CTF) and executing sell orders on the Central Limit Order Book (CLOB) to optimize entry prices and reduce slippage. Furthermore, it features an intelligent hedge discovery engine that utilizes LLM-based logical analysis to identify correlated market pairs, allowing users to build risk-managed portfolios. It handles everything from position management and P&L tracking to setting stop-loss and take-profit thresholds, providing a professional-grade interface for decentralized prediction market speculation.

Installation

To integrate this skill into your environment, run the following command in your terminal: clawhub install openclaw/skills/skills/sa9saq/rey-polymarket-trader. Before execution, ensure your environment variables are configured. You will need a POLYGON_RPC_URL (Alchemy or Chainstack recommended), a POLYMARKET_PRIVATE_KEY for transaction signing, and an OPENROUTER_API_KEY to power the hedge discovery analysis. It is highly recommended to use a residential proxy if you are making frequent requests to the Polymarket interface to avoid rate-limiting or IP-based restrictions.

Use Cases

• Strategic Speculation: Users can take advantage of news events by rapidly entering positions on election outcomes, sports results, or economic indicators using the Split+CLOB strategy for better execution prices.
• Risk-Neutral Hedging: By analyzing logical contradictions between two markets (e.g., if Candidate A winning precludes Candidate B winning), the skill identifies pairs where one position can offset the risk of another, creating a balanced portfolio.
• Automated Portfolio Monitoring: The skill keeps track of your entry prices and current market valuations, providing real-time P&L feedback, which is crucial for managing volatile assets on the blockchain.

Example Prompts

1. "Polymarket, please search for markets related to the 2024 presidential election and show me the current YES/NO odds for the top three."
2. "I want to place a $200 bet on the YES outcome for the current trending crypto market. Use the Split+CLOB strategy to minimize slippage."
3. "Scan all my current open positions and suggest a hedging strategy to reduce exposure in my high-risk portfolios."

Tips & Limitations

Prediction markets are inherently high-risk. Always adhere to the recommended risk management rules: cap individual market exposure at 10% of your total capital and maintain a minimum of 5 distinct market positions to diversify. Be aware that the Split+CLOB strategy relies on sufficient liquidity; if the CLOB order book is thin, the execution price may not be as favorable as expected. Additionally, verify your local jurisdiction's stance on decentralized prediction markets, as they may be regulated similarly to gambling or financial derivatives. Never use a key that holds more funds than you are willing to risk in a single session.