luckylobster-skill_skill

Overview

This skill lets an agent search Polymarket prediction markets, place orders, and manage positions via a secure API. It supports device-based authentication, real-time market data, and CLOB trading primitives so agents can trade outcome tokens programmatically. It is designed for automated traders that need fast market discovery and order execution on Polymarket.

How this skill works

The skill uses a REST API with an API key obtained through a device authorization flow; agents request a device code, direct the user to the verification URL, then poll for the returned API key. Once authorized, the skill calls endpoints to search markets, fetch market details and token IDs, retrieve order books/prices/spreads, and submit orders (LIMIT, MARKET, FOK, FAK). WebSocket-backed real-time data is used when available to reduce latency for open positions.

When to use it

• Automatically discover and trade Polymarket markets from natural-language queries.
• Execute programmatic trading strategies using CLOB token IDs and live order books.
• Monitor open positions and use cached websocket prices for low-latency decisions.
• Quickly find deterministic crypto up/down markets (15m/hourly/daily) via the crypto endpoint.
• Integrate prediction-market trades into portfolio or decision-making workflows.

Best practices

• Use /markets/crypto for deterministic crypto markets instead of text search when available.
• Always retrieve tokens[].tokenId or clobTokenIds from /markets/{id} before trading.
• Save the API key persistently after device auth; it is returned only once.
• Respect rate limits (default 100 requests/min) and inspect X-RateLimit headers to avoid throttling.
• Prefer MARKET or FOK for quick fills and LIMIT for passive placement; check order status in the response.

Example use cases

• Search for a high-liquidity election market, fetch token IDs, and place a limit buy on the favored outcome.
• Monitor Bitcoin 15-minute up/down markets and place automated scalps using /markets/crypto and /prices.
• Aggregate spreads and orderbook summaries across multiple tokens to detect arbitrage or liquidity imbalances.
• Cancel or modify stale LIMIT orders programmatically and redeem settled winning positions.