API · סוכני AI

רוב הבוטים לפולימרקט ב-2026 נבנים על ידי הנחיית סוכן קוד מבוסס-AI - Claude Code, Cursor, Copilot. זה בסדר, אם שומרים את הסוכן על ה-API הנוכחי V2 ועל מעקה בטיחות. העמוד הזה מראה איך: להתקין את הכללים + הכלים לקריאה-בלבד שלנו כדי שהקוד שנוצר יהיה נכון ויתחיל במצב נייר, ולעקוב אחרי הצ'ק-ליסט לפני שמשהו נוגע בכסף אמיתי.

תנו לסוכן שלכם את הכללים קודם. שימו את AGENTS.md שלנו במאגר (Claude Code, Cursor, Copilot ואחרים קוראים אותו). הוא מקבע את ה-SDK של V2, את כתובות הבסיס, את חוזי ה-pUSD, את המלכודות, ומסילת כסף שברירת המחדל שלה היא נייר - כך שהסוכן מפסיק לכתוב קוד V1 מת (py-clob-client 0.34 / USDC.e).

הגדירו את הסוכן שלכם

  • כללים: הוסיפו את AGENTS.md לשורש המאגר (ו- CLAUDE.md כקישור סימבולי / מראה .cursor/rules).
  • הקשר: הפנו את הסוכן ל-llms.txt ולמדריך ה-API שלנו כדי שיעגן תשובות במסמכים הנוכחיים, לא בניחוש מהאימון שלו.
  • נתוני עיגון: התקינו את ה-MCP לקריאה-בלבד כך שמזהי הטוקנים יגיעו משווקים חיים, לא מהזיות.
  • ייצור קוד: ללקוחות מטופסים, הפנו את המחולל שלכם למפרטים הקריאים-למכונה של פולימרקט - CLOB OpenAPI, Data OpenAPI ומפרט ה-AsyncAPI (WebSocket) - כך שהסוכן בונה מול הסכימה האמיתית, לא מול ניחוש.

צ'ק-ליסט לתכנות-בטוח

העמידו כל בוט מסחר שנוצר על ידי AI בדרישות האלה לפני שאתם נותנים לו לרוץ חי:

  1. התחילו בקריאה-בלבד - קודם נתוני שוק, ללא פקודות.
  2. מצב נייר כברירת מחדל; מסחר חי דורש דגל --live מפורש.
  3. מפתחות במשתני סביבה בלבד - לעולם לא מוטמעים בקוד, לא בלוגים, ולא ב-commit.
  4. קבעו את ה-SDK הרשמי של V2 + כתובות הבסיס כדי שהסוכן לא יוכל להמציא endpoints.
  5. עגנו על ה-spec / MCP - אל תסמכו על endpoint שהסוכן "זוכר".
  6. כשלו-סגור על נתונים פגומים - לעולם אל תבצעו עסקה על שליפה כושלת או ריקה.
  7. סקירה אנושית לפני הריצה החיה הראשונה.
  8. מגבלות פוזיציה והפסד קשיחות + kill switch.
למה זה חשוב. בוטים למסחר שתוכנתו ברישול נכשלים בדרכים ידועות: מסחר על מחירים הזויים, שימוש בתבניות 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.

הסוכן אמור לייצר קוד במצב נייר, עם מזהי טוקן אמיתיים (מה-MCP/נתונים חיים), מפתחות הנקראים מהסביבה, וללא נתיב פקודות חי אלא אם תוסיפו --live בעצמכם.

תנו לסוכן שלכם שווקים אמיתיים

מזהי טוקן הזויים הם באג התכנות-ברישול מספר 1. חפשו שוק אמיתי כאן, העתיקו את המזהים שלו, ומסרו אותם לסוכן (או תנו ל-MCP לעשות זאת):

הבא: כללי ה-AGENTS.md · באיזה SDK להשתמש · מתכונים להעתקה · עיון ב-CLOB · תיקון שגיאה · תבניות פתיחה.

אין זה ייעוץ פיננסי. מסחר אוטומטי מסכן כסף אמיתי - בדקו במצב נייר וסקרו לפני עלייה לאוויר.