polymarket-edge_skill

Overview

This skill wraps Polymarket Gamma and CLOB APIs to trade and analyze prediction markets using a 5-minute EMA(5/20) crossover strategy. It provides market browsing, order book inspection, signal generation, a background auto-trader, and portfolio views. Calls are billed per request via SkillPay.me.

How this skill works

The skill fetches 5-minute YES-token price candles and order book data from Polymarket, computes EMA(5) and EMA(20), and generates per-market signals: BUY_YES, BUY_NO, HOLD, or SKIP. It filters signals by spread and price bounds, exposes endpoints to inspect markets and history, and can run a background auto-trader that places orders when enabled and a private key is provided. Billing is enforced per-call and endpoints require a user_id query parameter.

When to use it

• When you want rule-based signals for BTC/Bitcoin prediction markets on Polymarket
• When you need quick order book and mid-price context before placing trades
• To automate small, short-term trades using a lightweight EMA crossover strategy
• To monitor a wallet’s open positions and USD exposure in Polymarket markets
• When you want a locally-run API that integrates analysis, signals, and optional live execution

Best practices

• Run the skill locally and use a burner EVM private key for live trading; never expose your main keys
• Confirm spread and price filters before enabling auto-trade to avoid illiquid markets
• Monitor the autotrader logs and run in a controlled environment (small position sizes initially)
• Top up SkillPay.me tokens for each user_id that will call the API to avoid 402 errors
• Use the /market/{token_id}/book and /market/{token_id}/history endpoints to validate signals before executing

Example use cases

• Scan active BTC markets and get EMA-based BUY/SELL/HOLD signals for manual or automated trading
• Run the auto-trader as a background task to execute the 5-minute cycle and log trade activity
• Integrate market mid-price and spread data into a dashboard or trading bot frontend
• Query a wallet’s portfolio to reconcile Polymarket positions and USD value
• Use the history endpoint to backtest the EMA crossover on recent 5-minute candles