API · مرجع

تغيّرت أسماء SDK في Polymarket مع CLOB V2، وصار هناك عدة خيارات - لذا «أيّها؟» هو أكثر أسئلة 2026 شيوعاً. الجواب المختصر: استخدم عميل CLOB V2 للغتك، واستعِن بـ Rust إن كنت تتداول من محفظة إيداع أو تحتاج كموناً منخفضاً. عملاء V1 القدامى مؤرشفون.

لا تستخدم خط V1. Python py-clob-client (أحدث إصدار 0.34.x) مؤرشف وغير عامل؛ و Node @polymarket/clob-client بات مُستبدَلاً. لا وجود لـ «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 / نوع التوقيع 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 (لا 0.x py-clob-client)؛ وبيانات الاعتماد تدخل في المُنشئ كـ creds= (لا وجود لـ set_api_creds)؛ وتقدّم الأمر باستدعاء واحد عبر create_and_post_order(...) بدلاً من create_order ثم post_order. والضمان هو pUSD، لا USDC.e.

جرّب استدعاءً (بلا تثبيت)

كل SDK أعلاه يغلّف نفس نقاط النهاية العامة هذه - شغّل واحداً مباشرة لترى الشكل قبل أن تختار:

التالي: المصادقة والمحافظ · مرجع واجهة CLOB API · أصلِح خطأ SDK.