מדריך ה-API של פולימרקט - בנו את בוט המסחר הראשון שלכם ב-2026

פרק 27 מתוך 33

הגרסה הקצרה

פולימרקט חושף שלושה API ציבוריים: CLOB (מסחר), Gamma (גילוי שווקים) ו-Data (אנליטיקה). ה-SDK הרשמי של Python הוא py-clob-client 0.34.6. האימות משתמש ב-מפתח API + חתימת ECDSA, כאשר הפקודות נחתמות באמצעות EIP-712 דרך ארנק proxy ב-Polygon. מגבלות הקצב מגבילות אתכם לכ-60 פקודות לדקה לכל מפתח. המכשול הגדול ביותר למפתחים חדשים הוא בעיית המיפוי בין condition_id ל-token_id בין Gamma ל-CLOB - פתרו אותה ראשונה, וכל השאר יסתדר. בכל חודש מרוויחים על פולימרקט כ-40 מיליון $ בתגמולי נזילות ובמרווח שבוטים לוכדים, כמעט כולו על ידי משתמשי API.

חלק 1: שלושת ה-API

פולימרקט מפריד באופן נקי בין תחומי האחריות לשלושה שירותים נפרדים. שימוש ב-API הנכון לכל משימה שומר על הבוט שלכם מהיר, פשוט ובתוך מגבלות הקצב.

לולאת בוט טיפוסית משתמשת ב-Gamma כדי למצוא שווקים, ב-CLOB כדי למשוך ספרי פקודות ולשלוח עסקאות, וב-Data כדי לבצע back-test לביצועי האסטרטגיה באופן לא מקוון. חשבו על Gamma כ"קטלוג", על CLOB כ"בורסה", ועל Data כ"מחסן".

חלק 2: אימות ומודל ארנק ה-Proxy

פולימרקט אינו חותם על עסקאות עם המפתח הפרטי של הארנק הראשי שלכם. במקום זאת, הוא משתמש ב-ארנק proxy בסגנון Gnosis Safe: הארנק הראשי שלכם מאשר proxy, וה-proxy מבצע את כל העסקאות ב-Polygon. בוט ה-API שלכם מדבר עם אותו proxy.

מה אתם צריכים

• מפתח API - נוצר ב-Settings → Developer של פולימרקט
• מפתח פרטי - המפתח של ארנק המסחר שלכם (לא ה-seed phrase של ה-MetaMask הראשי)
• כתובת funder - כתובת ארנק ה-proxy שלכם (מוצגת ב-Settings → Wallet)
• Chain ID - 137 (Polygon mainnet)
• Signature type - 1 (POLY_PROXY, סטנדרטי למשתמשי קמעונאות)

חלק 3: התקנת py-clob-client

ה-SDK הרשמי של Python הוא הדרך המהירה ביותר לעבור מאפס לפקודה ראשונה. נשתמש בגרסה 0.34.6, שהיא הנוכחית נכון לאפריל 2026.

# Create a virtual environment first
python3 -m venv venv
source venv/bin/activate # macOS/Linux
venv\Scripts\activate # Windows

# Install the SDK
pip install py-clob-client==0.34.6 requests websocket-client python-dotenv

הגדרת לקוח בסיסית

import os
from dotenv import load_dotenv
from py_clob_client.client import ClobClient
from py_clob_client.constants import POLYGON

load_dotenv()

client = ClobClient(
 host="https://clob.polymarket.com",
 key=os.environ["POLY_PRIVATE_KEY"],
 chain_id=POLYGON, # 137
 signature_type=1, # POLY_PROXY
 funder=os.environ["POLY_FUNDER"],
)

# One-time: derive and cache API credentials
client.set_api_creds(client.create_or_derive_api_creds())

הקריאה ל-create_or_derive_api_creds() חותמת על הודעה עם המפתח הפרטי שלכם ומחליפה אותה במפתח API, secret ו-passphrase. שמרו אותם ב-.env לאחר ההרצה הראשונה כדי שלא תפנו לנקודת הקצה של הגזירה בכל הפעלה.

חלק 4: גילוי שווקים דרך Gamma

לפני שתוכלו לסחור, אתם צריכים למצוא שווקים ששווה לסחור בהם. Gamma מחזיר JSON עם כל מה שממשק פולימרקט מציג: שאלה, תוצאות, מחירים, נפח 24ש', תפוגה, תגיות ותמונות.

import requests

resp = requests.get(
 "https://gamma-api.polymarket.com/markets",
 params={
 "active": "true",
 "closed": "false",
 "tag_slug": "politics",
 "limit": 20,
 "order": "volume24hr",
 "ascending": "false",
 },
 timeout=10,
)
resp.raise_for_status()
markets = resp.json()

for m in markets:
 print(f"{m['slug']:50} Yes ${float(m['outcomePrices'][0]):.3f} Vol24h ${m.get('volume24hr', 0):,.0f}")

פרמטרים שימושיים לשאילתת Gamma

חלק 5: המיפוי בין condition_id ל-token_id

זוהי נקודת הכאב מספר 1 בפיתוח בוטים לפולימרקט. Gamma מחזיר condition_id (אחד לכל שוק). עסקאות CLOB משתמשות ב-token_id (אחד לכל תוצאה). אתם תמיד צריכים את שניהם.

# Each Gamma market object contains 'clobTokenIds' - a JSON string array
import json

market = markets[0]
token_ids = json.loads(market['clobTokenIds']) # ['7410...', '1120...']
yes_token = token_ids[0] # First outcome
no_token = token_ids[1] # Second outcome

# Alternative: ask CLOB directly using condition_id
info = client.get_market(condition_id=market['conditionId'])
yes_token = info['tokens'][0]['token_id']

מכשול סדר התוצאות

מערך ה-outcomes ומערך ה-clobTokenIds של Gamma מותאמים באינדקס. תמיד קראו את תווית התוצאה במקום להניח שאינדקס 0 הוא 'Yes'. בשווקים רב-תוצאתיים (NegRisk, אוסקר, בחירות), אינדקס 0 יכול להיות 'Kamala Harris' או 'Taylor Swift' - הסדר דטרמיניסטי אך ספציפי לשוק.

חלק 6: קריאת ספרי פקודות

book = client.get_order_book(token_id=yes_token)

best_bid = float(book.bids[0].price) if book.bids else None
best_ask = float(book.asks[0].price) if book.asks else None
mid = (best_bid + best_ask) / 2 if best_bid and best_ask else None
spread = best_ask - best_bid if best_bid and best_ask else None

print(f"Bid {best_bid} Ask {best_ask} Mid {mid:.4f} Spread {spread:.4f}")

ספרי פקודות מוחזרים כמערכים ממוינים (bids בסדר יורד, asks בסדר עולה). לכל רמה יש price ו-size. כדי להעריך slippage עבור פקודה גדולה יותר, עברו על הספר וצברו נפח עד שצרכתם את גודל היעד שלכם.

חלק 7: שליחת פקודות

פקודת גבול (GTC - ברירת המחדל)

from py_clob_client.clob_types import OrderArgs, OrderType

args = OrderArgs(
 token_id=yes_token,
 price=0.45,
 size=100, # Shares, not dollars. 100 shares @ $0.45 = $45 max cost.
 side="BUY",
)
signed_order = client.create_order(args)
response = client.post_order(signed_order, OrderType.GTC)
print(response)

הקריאה ל-create_order חותמת על הודעה מובנית של EIP-712 עם המפתח הפרטי שלכם. post_order שולח אותה ל-CLOB. אתם לעולם לא שולחים מפתחות פרטיים גולמיים ברשת - רק פקודות חתומות.

סוגי פקודות

ביטול

# Single order
client.cancel(order_id="0xabc...")

# Cancel all orders on a specific market
client.cancel_market_orders(market=market['conditionId'])

# Nuclear option: cancel everything
client.cancel_all()

חלק 8: סטרימינג ב-WebSocket

סקירת Gamma כל שנייה היא בזבזנית ותגיעו למגבלות הקצב מהר. ה-feed של WebSocket מזרים עדכוני ספר פקודות ועסקאות בזמן אמת, בהשהיה תת-שנייתית.

import json, websocket

WS_URL = "wss://ws-subscriptions-clob.polymarket.com/ws/market"

def on_open(ws):
 ws.send(json.dumps({
 "type": "market",
 "assets_ids": [yes_token, no_token],
 }))

def on_message(ws, message):
 event = json.loads(message)
 if event.get("event_type") == "price_change":
 print(f"{event['market']} {event['side']} {event['price']} size={event['size']}")

ws = websocket.WebSocketApp(
 WS_URL,
 on_open=on_open,
 on_message=on_message,
)
ws.run_forever(ping_interval=20)

קיימים שני feeds: ה-feed של /market (ספר פקודות ועסקאות ציבוריים) וה-feed של /user (אירועי הפקודות והמילויים שלכם, מאומת). בוטים בייצור מתחברים בדרך כלל לשניהם, מתחברים מחדש אוטומטית בניתוק, ומתייחסים ל-WebSocket כמקור האמת למצב הספר הנוכחי.

חלק 9: מגבלות קצב ו-Backoff

כשאתם נתקלים ב-HTTP 429, השרת מחזיר כותרת Retry-After. יישמו backoff מעריכי עם jitter:

import random, time

def post_with_backoff(fn, *args, max_retries=6):
 for attempt in range(max_retries):
 try:
 return fn(*args)
 except Exception as e:
 if "429" in str(e):
 sleep = (2 ** attempt) + random.random()
 time.sleep(min(sleep, 30))
 continue
 raise
 raise RuntimeError("Too many retries")

חלק 10: ארכיטקטורת בוט לדוגמה

לכל בוט פולימרקט חסון יש את אותם שישה רכיבים. בנו כל אחד כמודול נפרד; שמרו עליהם מקושרים באופן רופף.

חלק 11: כשלים נפוצים

• נתוני WebSocket מיושנים - עקבו אחר זמן ההודעה האחרונה לכל נכס; אם אין עדכונים במשך >30ש' בשוק פעיל, אלצו רענון REST.
• התנגשויות nonce - py-clob-client מטפל ב-nonce של פקודות עבורכם, אך אם אתם כותבים חותם משלכם, הגדילו את ה-nonce בכל פקודה.
• יתרה לא מספקת - תמיד בדקו את יתרת ה-pUSD לפני שליחה; הספר עשוי להציג את הפקודה שלכם אך ההתאמה תדחה אותה.
• שוק מושהה או נפתר - בדקו market.active && !market.closed לפני מסחר. עדכוני Gamma מפגרים אחרי CLOB בכמה שניות סביב הפתרון.
• אי-התאמה של מתאם NegRisk - שווקים רב-תוצאתיים מנותבים דרך מתאם NegRisk נפרד. ה-SDK מטפל בכך, אך ודאו שהפקודה שלכם הגיעה ל-venue הנכון.

חלק 12: תגמולי נזילות דרך ה-API

פולימרקט מריץ כ-5 מיליון $ לחודש בתגמולי נזילות כלליים בתוספת 5 מיליון $+ לחודש בתגמולים ייעודיים לספורט (ראו תגמולי נזילות). הרוב המכריע זורם ל-market makers מונעי-API שיכולים לתחזק ציטוטים דו-צדדיים צמודים על פני אלפי שווקים.

נוסחת התגמול מתגמלת פקודות סמוכות לאמצע, גודל וזמן-על-הספר. לולאת market making מינימלית:

1. קראו את ספר הפקודות עבור שוק היעד
2. חשבו אמצע הוגן (למשל, VWAP של 3 הרמות העליונות בכל צד)
3. פרסמו bid ב-mid − spread_target/2 ו-ask ב-mid + spread_target/2
4. בכל עדכון WebSocket, תמחרו מחדש אם הציטוט שלכם סוטה ביותר מ-tick אחד מהיעד
5. בטלו וצאו אם הספר מתדלדל או שמתפרצות חדשות

חלק 13: מעבר לסביבת ייצור

• אירוח: VPS ב-6 $ לחודש (Hetzner, DigitalOcean) באירופה או ב-US-East מספיק לרוב הבוטים. מקמו co-location עם Polygon RPC אם אתם צריכים השהיה תת-10ms.
• RPC: השתמשו ב-Alchemy, Infura או QuickNode ל-Polygon RPC אמין. ה-free tiers בסדר עד שאתם שולחים מאות פקודות לדקה.
• ניטור: Prometheus + Grafana למדדים; בוט Telegram להתראות. רשמו כל מזהה פקודה שאתם שולחים וכל מילוי שאתם מקבלים.
• גיבויים: שמרו מצב כל דקה. אם ה-VPS מת באמצע מילוי, אתם רוצים לחדש בשניות, לא להתאים ידנית.
• מס: הרושם שלכם הוא גם שובל הביקורת שלכם - ראו מדריך המס.

חלק 14 - טיפים מקצועיים מאומתים ל-API של פולימרקט

גיליון עזר: מצב → פעולה

מה הלאה?

• כלים ומשאבים - דאשבורדים, אנליטיקה ו-feeds של נתונים מצד שלישי שמשלימים את ה-API
• אסטרטגיות מתקדמות - ארביטראז' רב-רגלי ומבנים דמויי-אופציות המתאימים לבוטים
• תגמולי נזילות - נוסחאות מדויקות להרוויח rebate של market-making
• מדריך ספר הפקודות - אינטואיציה עמוקה יותר לקריאת הספר לפני שאתם כותבים קוד מולו
• מילון מונחים - הגדרות בעברית פשוטה לכל מונח במדריך זה