API · Agenci AI

Większość botów Polymarket w 2026 roku powstaje przez promptowanie agenta kodującego AI - Claude Code, Cursor, Copilot. To w porządku, jeśli utrzymasz agenta na aktualnym API V2 i na szynie bezpieczeństwa. Ta strona pokazuje jak: zainstaluj nasze reguły + narzędzia tylko do odczytu, by generowany kod był poprawny i startował w trybie paper, i przejdź przez listę kontrolną, zanim cokolwiek dotknie prawdziwych pieniędzy.

Najpierw daj agentowi reguły. Wrzuć nasz AGENTS.md do repozytorium (czytają go Claude Code, Cursor, Copilot i inne). Przypina SDK V2, bazowe adresy URL, kontrakty pUSD, pułapki i domyślny tryb paper - dzięki czemu agent przestaje pisać martwy kod V1 (py-clob-client 0.34 / USDC.e).

Skonfiguruj agenta

  • Reguły: dodaj AGENTS.md do katalogu głównego repozytorium (oraz dowiązanie CLAUDE.md / kopię .cursor/rules).
  • Kontekst: skieruj agenta na nasz llms.txt i dokumentację API, by ugruntował odpowiedzi w aktualnych dokumentach, a nie w zgadywaniu z treningu.
  • Dane do ugruntowania: zainstaluj MCP tylko do odczytu, by identyfikatory tokenów pochodziły z żywych rynków, a nie ze zmyśleń.
  • Generowanie kodu: dla typowanych klientów skieruj generator na maszynowo czytelne specyfikacje Polymarket - CLOB OpenAPI, Data OpenAPI oraz specyfikację AsyncAPI (WebSocket) - by agent budował wobec prawdziwego schematu, a nie zgadywania.

Lista kontrolna bezpiecznego vibe-codingu

Utrzymaj każdego bota tradingowego generowanego przez AI przy tych zasadach, zanim pozwolisz mu działać na żywo:

  1. Zacznij tylko do odczytu - najpierw dane rynkowe, żadnych zleceń.
  2. Domyślnie tryb paper; handel na żywo wymaga jawnej flagi --live.
  3. Klucze tylko w zmiennych środowiskowych - nigdy na sztywno, w logach ani w commitach.
  4. Przypnij oficjalne SDK V2 + bazowe adresy URL, by agent nie mógł wymyślać endpointów.
  5. Ugruntuj na specyfikacji / MCP - nie ufaj endpointowi, który agent „pamięta”.
  6. Wstrzymuj działanie przy błędnych danych - nigdy nie składaj transakcji na nieudanym lub pustym pobraniu.
  7. Weryfikacja przez człowieka przed pierwszym uruchomieniem na żywo.
  8. Twarde limity pozycji i strat + wyłącznik awaryjny.
Dlaczego to ważne. Vibe-code'owane boty tradingowe zawodzą w znany sposób: handlując na zmyślonych cenach, używając martwych wzorców V1, instalując zmyślone pakiety (slopsquatting) i zapisując klucze na sztywno. Plik reguł + MCP tylko do odczytu + rusztowanie paper-first domyślnie zamykają każdy z tych błędów.

Dobry pierwszy prompt

Using the Polymarket V2 API (py-clob-client-v2) and the AGENTS.md rules in this repo,
write a PAPER bot that finds the BTC-above-150k market, reads its order book, and would
buy Yes under 0.40. Do NOT place live orders. Keys from env only. Fail closed on bad data.

Agent powinien wygenerować kod w trybie paper, z prawdziwymi identyfikatorami tokenów (z MCP/żywych danych), kluczami odczytywanymi ze środowiska i bez ścieżki zleceń na żywo, dopóki sam nie dodasz --live.

Daj agentowi prawdziwe rynki

Zmyślone identyfikatory tokenów to błąd nr 1 vibe-codingu. Wyszukaj tu prawdziwy rynek, skopiuj jego identyfikatory i przekaż je agentowi (albo niech zrobi to MCP):

Dalej: Reguły AGENTS.md · Które SDK wybrać · Gotowe przepisy · Dokumentacja CLOB · Napraw błąd · Szablony startowe.

To nie porada finansowa. Automatyczny handel ryzykuje prawdziwe pieniądze - testuj w trybie paper i weryfikuj przed startem na żywo.