API · ШІ-агенти

Більшість ботів Полімаркет у 2026 будують, промптуючи ШІ-агента для кодування - Claude Code, Cursor, Copilot. Це нормально, якщо ви тримаєте агента на актуальному API V2 і на страхувальному обмежувачі. Ця сторінка показує як: встановіть наші правила + інструменти лише для читання, щоб згенерований код був коректним і починався в паперовому режимі, і дотримуйтеся чеклиста перед тим, як щось торкнеться реальних грошей.

Спершу дайте агенту правила. Покладіть наш AGENTS.md у ваш репозиторій (Claude Code, Cursor, Copilot та інші його читають). Він закріплює SDK V2, базові URL, контракти pUSD, підводні камені і паперовий режим за замовчуванням - тож агент перестає писати мертвий код V1 (py-clob-client 0.34 / USDC.e).

Налаштуйте свого агента

  • Правила: додайте AGENTS.md у корінь репозиторію (і символьне посилання CLAUDE.md / дзеркало .cursor/rules).
  • Контекст: спрямуйте агента на наш llms.txt і довідник API, щоб він заземляв відповіді в актуальній документації, а не в здогадах свого навчання.
  • Дані для заземлення: встановіть MCP лише для читання, щоб ID токенів надходили з живих ринків, а не з галюцинацій.
  • Генерація коду: для типізованих клієнтів спрямуйте свій генератор на машинозчитувані специфікації Полімаркет - CLOB OpenAPI, Data OpenAPI і специфікацію AsyncAPI (WebSocket) - щоб агент будував проти реальної схеми, а не здогаду.

Чеклист безпечного vibe-кодингу

Тримайте кожного ШІ-згенерованого торгового бота на цьому перед тим, як дозволити йому працювати наживо:

  1. Почніть лише з читання - спершу ринкові дані, без ордерів.
  2. Паперовий режим за замовчуванням; реальна торгівля потребує явного прапорця --live.
  3. Ключі лише у змінних середовища - ніколи не хардкодьте, не логуйте, не комітьте.
  4. Закріпіть офіційний SDK V2 + базові URL, щоб агент не вигадував ендпоінти.
  5. Заземліться на специфікації / MCP - не довіряйте ендпоінту, який агент «пам'ятає».
  6. Зупиняйтеся на поганих даних - ніколи не виставляйте угоду на невдалому чи порожньому запиті.
  7. Перевірка людиною перед першим реальним запуском.
  8. Жорсткі ліміти позиції та збитку + аварійний вимикач.
Чому це важливо. Vibe-кодовані торгові боти зазнають невдачі відомими способами: торгують на вигаданих цінах, використовують мертві патерни V1, встановлюють вигадані пакети (slopsquatting) і хардкодять ключі. Файл правил + MCP лише для читання + паперовий каркас закривають кожен із них за замовчуванням.

Хороший перший промпт

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.

Агент має видати код у паперовому режимі, з реальними ID токенів (з MCP/живих даних), ключами, зчитаними зі середовища, і без шляху реальних ордерів, доки ви самі не додасте --live.

Дайте агенту реальні ринки

Вигадані ID токенів - баг №1 vibe-кодингу. Знайдіть реальний ринок тут, скопіюйте його ID і передайте агенту (або дайте це зробити MCP):

Далі: Правила AGENTS.md · Який SDK використовувати · Готові рецепти · Довідник CLOB · Виправити помилку · Шаблони.

Не є фінансовою порадою. Автоматизована торгівля ризикує реальними грошима - тестуйте в паперовому режимі і перевіряйте перед реальним запуском.