API · עיון

שמות ה-SDK של פולימרקט השתנו עם CLOB V2, וכעת יש כמה - ולכן "באיזה?" היא השאלה הנפוצה ביותר של 2026. תשובה קצרה: השתמשו בלקוח ה-CLOB של V2 לשפה שלכם, ופנו לRust אם אתם סוחרים מארנק הפקדה או זקוקים להשהיה נמוכה. לקוחות ה-V1 הישנים אורכבו.

אל תשתמשו בקו ה-V1. ה-py-clob-client ב-Python (הגרסה האחרונה 0.34.x) מאורכב ובלתי-פעיל; ה-@polymarket/clob-client ב-Node הוחלף. אין "py-clob-client 0.40" - אם מדריך אומר זאת, הוא שגוי.

ה-SDK ב-2026

SDKחבילהלשימוש עבור
Python - V2 CLOBpy-clob-client-v2 (1.x)ברירת המחדל למסחר ב-Python. ייבאו py_clob_client_v2.
Node - V2 CLOB@polymarket/clob-client-v2ברירת המחדל למסחר ב-Node/TS (בנוי על viem).
Rust - V2 (רשמי)polymarket_client_sdk_v2השהיה נמוכה, עשיית שוק, וארנקי הפקדה (הלקוח היחיד שעובד ל-POLY_1271 כיום).
מאוחד (בטא)polymarket-client / @polymarket/clientפרויקטים חדשים - אך כרגע קריאה-בלבד (אין עדיין ביצוע פקודות).
Polymarket USpolymarket-us-pythonהפלטפורמה האמריקאית המפוקחת על ידי ה-CFTC (אימות Ed25519, מחסנית נפרדת).

במה כדאי לבחור?

  • קריאת נתוני שוק, בכל שפה ← כל לקוח V2, או ה-SDK המאוחד לקריאה-בלבד. לא נדרש מפתח.
  • ביצוע פקודות ב-Python ← py-clob-client-v2.
  • ביצוע פקודות ב-Node/TS ← @polymarket/clob-client-v2.
  • מסחר מארנק הפקדה (POLY_1271 / sig type 3) ← Rust (polymarket_client_sdk_v2). ללקוחות ה-Python/TS יש באג פתוח באימות ארנק הפקדה.
  • קריטי-להשהיה (HFT, עשיית שוק) ← Rust.
  • ארה"ב, מפוקח CFTC ← polymarket-us-python (Ed25519, polymarket.us).

התקנה

pip install py-clob-client-v2          # V2 CLOB client
npm install @polymarket/clob-client-v2
# Cargo.toml
polymarket_client_sdk_v2 = "0.5"       # official, repo rs-clob-client-v2
הגרסאות זזות שבועית. בדקו מחדש ב-PyPI / npm / crates.io את העדכני ביותר לפני שאתם מקבעים. נכון ליוני 2026: py-clob-client-v2 1.0.1, @polymarket/clob-client-v2 1.0.6, Rust כ-0.5-0.6.

הלקוח הראשון שלכם (אתחול + קריאה)

אותה צורה בכל שפה - בונים את הלקוח, קוראים ספר פקודות. קריאות אינן צריכות מפתח:

from py_clob_client_v2 import ClobClient
c = ClobClient(host="https://clob.polymarket.com", chain_id=137)
print(c.get_order_book(TOKEN_ID).asks[:3])
import { ClobClient } from "@polymarket/clob-client-v2";
const c = new ClobClient("https://clob.polymarket.com", 137);
console.log(await c.getOrderBook(TOKEN_ID));
use polymarket_client_sdk_v2::ClobClient;
let c = ClobClient::new("https://clob.polymarket.com", 137);
let book = c.get_order_book(token_id).await?;

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

עוברים מ-V1? שלושה שינויי שם תופסים את כולם: החבילה היא py-clob-client-v2 (לא py-clob-client של 0.x); פרטי ההזדהות נכנסים לבנאי כ- creds= (אין set_api_creds); ואתם מפרסמים בקריאה אחת עם create_and_post_order(...) במקום create_order ואז post_order. והבטוחה היא pUSD, לא USDC.e.

נסו קריאה (ללא צורך בהתקנה)

כל SDK שלמעלה עוטף את אותם ה-endpoints הציבוריים - הריצו אחד חי כדי לראות את הצורה לפני שאתם בוחרים:

הבא: אימות וארנקים · עיון ב-CLOB API · תיקון שגיאת SDK.