polymarket-knowledge

Polymarket CLOB API knowledge base for order management, WebSocket events, and trading operations. Use when working with order lifecycle (place, fill, cancel), debugging WebSocket USER_TRADE/USER_ORDER events, understanding API field mappings, or implementing trading logic.

1. Zainstaluj umiejętność w swoim projekcie Claude, dodając katalog .claude/skills/polymarket-knowledge do konfiguracji agenta.

2. Gdy pracujesz nad integracją API Polymarket, odwołaj się do umiejętności pytając o cykl życia zlecenia — otrzymasz mapowanie stanów (PENDING, OPEN, PARTIALLY_FILLED, FILLED, CANCELLED, EXPIRED) oraz odpowiadające im statusy API (delayed, live, matched, cancelled, expired).

3. Do debugowania zdarzeń WebSocket użyj umiejętności do weryfikacji poprawnych endpointów (wss://ws-subscriptions-clob.polymarket.com/ws/user dla zdarzeń USER_ORDER i USER_TRADE, /ws/market dla zdarzeń rynkowych) i typów zdarzeń (USER_ORDER: PLACEMENT, UPDATE, CANCELLATION; USER_TRADE: MATCHED, MINED, CONFIRMED, RETRYING, FAILED).

4. Przy implementacji logiki składania zleceń sprawdź w umiejętności wymagania minimalne (wartość 1 USDC, minimum 5 akcji, tick size 0.01) oraz dostępne typy zleceń — GTC dla zleceń maker, GTD dla czasowo ograniczonych, FOK dla muszą być całkowicie wypełnione, FAK dla częściowego wypełnienia.

5. Gdy napotkasz błędy mapowania pól, skonsultuj się z umiejętnością w sprawie typowych pułapek — API używa matched_amount zamiast matched_size, wymaga uwierzytelnienia dla endpointu /ws/user i operuje na USDC jako walucie rozliczeniowej.

6. Dla złożonych scenariuszy handlowych odwołaj się do diagramu stanów zleceń w umiejętności, aby zrozumieć możliwe przejścia między stanami i warunki przejścia.