prediction-markets-gina_skill

Overview

This skill lets your agent search, trade, and automate strategies on Polymarket through the Gina prediction markets API. It connects via an MCP-compatible server URL and supports market discovery, on-chain trades, position tracking, and scheduled automations. Use natural language prompts — no special syntax required.

How this skill works

The agent talks to Gina’s MCP endpoint to search markets, run SQL-style filters, place market or limit orders on Polymarket (Polygon/USDC), and manage positions. Authentication uses OAuth 2.1 with PKCE; wallets are self-custodial via Privy so you keep your keys. Automations (Recipes) run scheduled scans, alerts, and trades, while large trades require explicit confirmation.

When to use it

• Discover markets by topic, date, liquidity, or volume before trading.
• Place market or limit orders and monitor open orders and P&L.
• Scan for expiring or recurring markets to exploit short-term opportunities.
• Automate routine workflows: daily briefings, odds-swing alerts, or portfolio updates.
• Analyze market sets with SQL queries to build data-driven strategies.

Best practices

• Start with read-only queries (search, trending, SQL) to learn market behavior before trading.
• Use limit orders to control slippage and review large trades manually.
• Schedule small-scale test Recipes to validate automation logic before scaling up.
• Keep funds in a self-custodial wallet and never share private keys; decline any auth flow requesting keys.
• Enable briefings and alerts to catch rapid odds swings and expiring markets.

Example use cases

• Find all BTC prediction markets expiring within 24 hours and buy Yes on strong-momentum picks.
• Run a daily 9 AM briefing that lists top trending markets, portfolio P&L, and flagged odds swings.
• Place a limit order to buy Yes at 0.40 on an AAPL event and cancel if price doesn’t fill.
• Set up a Recipe to scan recurring SOL markets, place micro bets, and journal results for strategy refinement.
• Redeem winnings automatically from resolved markets and summarize returns weekly.