كيفية استخدام واجهة سطر الأوامر Polymarket؟

ملخص سريع

Polymarket CLI هي أداة سطر أوامر مبنية على Rust تتيح لك تصفح أسواق التنبؤ، ووضع الأوامر، وإدارة المراكز، والتفاعل مع العقود على السلسلة مباشرة من طرفيتك. يمكنك التثبيت عبر Homebrew أو سكريبت shell، وتصفح الأسواق بدون محفظة، والتداول باستخدام مخرجات JSON للأتمتة. تتطلب مفتاحًا خاصًا لعمليات التداول. تدعم تنسيقات الإخراج الجدولية وJSON للاستخدام البشري والبرمجي.

مقدمة

برزت أسواق التنبؤ كأدوات قوية للتنبؤ بالأحداث الواقعية، من نتائج الانتخابات إلى تحركات أسعار العملات المشفرة. يقدم Polymarket، المبني على Polygon، أحد أكثر أسواق التنبؤ سيولة بحجم تداول يبلغ ملايين الدولارات. وبينما تعد الواجهة الويب بديهية، غالبًا ما يرغب المطورون في الوصول البرمجي للأتمتة والسكربتات وبناء روبوتات تداول مخصصة.

هنا يأتي دور Polymarket CLI. توفر أداة سطر الأوامر هذه، المبنية على Rust، وصولاً كاملاً إلى نظام Polymarket البيئي من طرفيتك. سواء كنت ترغب في تصفح الأسواق، أو تحليل دفاتر الطلبات، أو تنفيذ الصفقات تلقائيًا، فإن Polymarket CLI توفر واجهة قوية تتكامل بسلاسة مع سكريبتات shell وسير عمل الأتمتة.

💡

للمطورين الذين يقومون ببناء تكاملات مع واجهات برمجة تطبيقات أسواق التنبؤ، يعد وجود أدوات اختبار واجهة برمجة التطبيقات المناسبة أمرًا بالغ الأهمية. يوفر Apidog منصة شاملة لتطوير واجهات برمجة التطبيقات تعمل بشكل مثالي جنبًا إلى جنب مع Polymarket CLI لاختبار تكاملات التداول الخاصة بك وتصحيحها والتحقق من صحتها.

زر

ما هو Polymarket؟

Polymarket هي منصة لامركزية لأسواق التنبؤ مبنية على بلوكتشين Polygon. تتيح للمستخدمين التداول على نتائج الأحداث الواقعية باستخدام العملة المستقرة USDC. يتم تنظيم الأسواق في شكل أسئلة نعم/لا، حيث تمثل الأسعار احتمالية وقوع النتيجة (على سبيل المثال، 52 سنتًا تعني احتمالية 52%).

تشمل الميزات الرئيسية لـ Polymarket ما يلي:

التداول اللامركزي: مبني على Polygon لمعاملات سريعة ومنخفضة التكلفة
الأسواق في الوقت الفعلي: آلاف الأسواق التي تغطي السياسة والعملات المشفرة والرياضة والمزيد
نموذج دفتر الطلبات: دفتر طلبات حدية مركزي (CLOB) لاكتشاف الأسعار
الرموز الشرطية: رموز ERC-1155 تمثل حصص النتائج
برنامج المكافآت: يمكن للمتداولين كسب مكافآت بناءً على حجم التداول

يتصل Polymarket CLI بهذه الأسواق من خلال مزيج من واجهات برمجة التطبيقات خارج السلسلة (لقراءة بيانات السوق ووضع الأوامر) والعقود على السلسلة (لعمليات الرموز مثل التقسيم والدمج والاسترداد).

تثبيت Polymarket CLI

يدعم Polymarket CLI طرق تثبيت متعددة. اختر الطريقة التي تناسب بيئتك.

الخيار 1: Homebrew (macOS / Linux)

أسهل طريقة للتثبيت تستخدم Homebrew:

# Add the Polymarket tap
brew tap Polymarket/polymarket-cli https://github.com/Polymarket/polymarket-cli

# Install polymarket
brew install polymarket

الخيار 2: سكريبت Shell (Linux/macOS)

للتثبيت السريع بسطر واحد:

curl -sSL https://raw.githubusercontent.com/Polymarket/polymarket-cli/main/install.sh | sh

يقوم هذا بتنزيل أحدث ملف تنفيذي وتثبيته في مسار PATH الخاص بك.

الخيار 3: البناء من المصدر (جميع المنصات)

إذا كان لديك Rust مثبتًا، يمكنك البناء من المصدر:

git clone https://github.com/Polymarket/polymarket-cli
cd polymarket-cli
cargo install --path .

التحقق من التثبيت

تحقق من نجاح التثبيت:

polymarket --version
polymarket --help

يجب أن ترى معلومات الإصدار ورسالة مساعدة مع الأوامر المتاحة.

بدء سريع: تصفح الأسواق بدون محفظة

إحدى أفضل ميزات Polymarket CLI هي أنك لا تحتاج إلى محفظة لتصفح الأسواق. وهذا يجعلها مثالية للبحث والمراقبة قبل الالتزام بالأموال.

تصفح الأسواق الأخيرة

# List the 5 most recent markets
polymarket markets list --limit 5

المخرجات المتوقعة:

البحث عن أسواق محددة

# Search for Bitcoin-related markets
polymarket markets search "bitcoin" --limit 5

التصفية حسب الحالة والحجم

# List closed markets
polymarket markets list --closed true --limit 20

تصفح الأحداث

تقوم الأحداث بتجميع الأسواق ذات الصلة معًا. على سبيل المثال، يحتوي حدث "انتخابات 2024" على أسواق متعددة حول جوانب مختلفة من الانتخابات.

# List recent events
polymarket events list --limit 10

# Filter events by tag
polymarket events list --tag politics --active true

# Get a specific event
polymarket events get 500

إعداد المحفظة وتكوينها

بينما لا يتطلب التصفح محفظة، فإن التداول يتطلب ذلك. إليك كيفية إعداد محفظتك.

إنشاء محفظة جديدة

# Create a new wallet (generates random key, saves to config)
polymarket wallet create

يولد هذا مفتاحًا خاصًا جديدًا ويخزنه في ملف التكوين الخاص بك في ~/.config/polymarket/config.json.

استيراد محفظة موجودة

إذا كان لديك بالفعل محفظة بأموال:

polymarket wallet import 0xYOUR_PRIVATE_KEY_HERE

موقع ملف التكوين

يتم تخزين ملف التكوين في ~/.config/polymarket/config.json ويبدو كالتالي:

{
  "private_key": "0xabc123...",
  "chain_id": 137,
  "signature_type": "proxy"
}

طرق تكوين المحفظة

يمكنك توفير مفتاحك الخاص بثلاث طرق (يتم التحقق منها بهذا الترتيب):

علامة سطر الأوامر (CLI flag): --private-key 0xabc...
متغير البيئة (Environment variable): POLYMARKET_PRIVATE_KEY=0xabc...
ملف التكوين (Config file): ~/.config/polymarket/config.json

أنواع التوقيع

يدعم Polymarket ثلاثة أنواع من التوقيعات:

النوع	الوصف
`proxy` (افتراضي)	يستخدم نظام محفظة Polymarket الوكيل
`eoa`	يوقع مباشرة باستخدام مفتاحك
`gnosis-safe`	للمحافظ متعددة التوقيع

يمكن تجاوز الإعداد لكل أمر باستخدام --signature-type eoa.

التحقق من حالة المحفظة

# Show full wallet info
polymarket wallet show

# Print just the address
polymarket wallet address

موافقات العقود

قبل التداول، تحتاج إلى الموافقة على عقود Polymarket:

# Check current approvals (read-only)
polymarket approve check

# Approve all contracts (sends 6 on-chain transactions)
polymarket approve set

ملاحظة: تتطلب الموافقة على العقود توفر MATIC لرسوم الغاز على شبكة Polygon.

استكشاف الأسواق والأحداث

دعنا نتعمق أكثر في أوامر استكشاف السوق.

أوامر السوق

# Get detailed market info
polymarket markets get will-bitcoin-hit-100k

# Get tags for a market
polymarket markets tags MARKET_ID

# List markets with various filters
polymarket markets list \
  --active true \
  --order volume_num \
  --limit 20 \
  --offset 10

أوامر الأحداث

# List events with filters
polymarket events list --active true --limit 10

# Get event tags
polymarket events tags EVENT_ID

# Series (recurring events like weekly markets)
polymarket series list --limit 10
polymarket series get SERIES_ID

أوامر العلامات

# List all tags
polymarket tags list

# Get specific tag info
polymarket tags get politics

# Find related tags
polymarket tags related politics

أوامر دفتر الطلبات (CLOB)

تحقق من الأسعار ودفاتر الطلبات بدون محفظة:

# Check API health
polymarket clob ok

# Get price for a token
polymarket clob price TOKEN_ID --side buy
polymarket clob midpoint TOKEN_ID

# Get spread
polymarket clob spread TOKEN_ID

# Get order book
polymarket clob book TOKEN_ID

# Last trade price
polymarket clob last-trade TOKEN_ID

# Price history
polymarket clob price-history TOKEN_ID --interval 1d --fidelity 30

خيارات الفترة: 1 دقيقة، 1 ساعة، 6 ساعات، 1 يوم، 1 أسبوع، الحد الأقصى

التداول على Polymarket

الآن يأتي الجزء المثير - وضع الصفقات. تتطلب هذه الأوامر محفظة مهيأة.

وضع الأوامر

# Place a limit order (buy 10 shares at $0.50)
polymarket clob create-order \
  --token TOKEN_ID \
  --side buy \
  --price 0.50 \
  --size 10

# Place a market order (buy $5 worth)
polymarket clob market-order \
  --token TOKEN_ID \
  --side buy \
  --amount 5

# Post multiple orders at once
polymarket clob post-orders \
  --tokens "TOKEN1,TOKEN2" \
  --side buy \
  --prices "0.40,0.60" \
  --sizes "10,10"

أنواع الأوامر: GTC (صالح حتى الإلغاء - افتراضي)، FOK (نفّذ أو ألغِ)، GTD (صالح حتى تاريخ)، FAK (نفّذ وألغِ)

أضف --post-only لأوامر الحد التي تضيف سيولة فقط.

إدارة الأوامر

# View your orders
polymarket clob orders

# Get specific order details
polymarket clob order ORDER_ID

# Cancel a single order
polymarket clob cancel ORDER_ID

# Cancel multiple orders
polymarket clob cancel-orders "ORDER1,ORDER2"

# Cancel all orders for a market
polymarket clob cancel-market --market CONDITION_ID

# Cancel all orders
polymarket clob cancel-all

التحقق من الأرصدة والصفقات

# Check USDC balance
polymarket clob balance --asset-type collateral

# Check conditional token balance
polymarket clob balance --asset-type conditional --token TOKEN_ID

# View your trades
polymarket clob trades

# Update balance (refresh from chain)
polymarket clob update-balance --asset-type collateral

المكافآت ومفاتيح API

# Check rewards
polymarket clob rewards --date 2024-06-15
polymarket clob current-rewards

# Check if orders are scoring rewards
polymarket clob order-scoring ORDER_ID

# Create API key for programmatic access
polymarket clob create-api-key

# List your API keys
polymarket clob api-keys

عمليات على السلسلة

يدعم Polymarket CLI أيضًا التفاعل المباشر مع العقود على السلسلة.

عمليات CTF (إطار العمل للرموز الشرطية)

# Split $10 USDC into YES/NO tokens
polymarket ctf split --condition CONDITION_ID --amount 10

# Merge tokens back to USDC
polymarket ctf merge --condition CONDITION_ID --amount 10

# Redeem winning tokens after resolution
polymarket ctf redeem --condition CONDITION_ID

ملاحظة: تتطلب العمليات على السلسلة توفر MATIC لرسوم الغاز على شبكة Polygon.

عمليات الجسر

إيداع الأصول من سلاسل كتل أخرى:

# Get deposit addresses for EVM, Solana, Bitcoin
polymarket bridge deposit YOUR_POLYGON_ADDRESS

# List supported chains and tokens
polymarket bridge supported-assets

# Check deposit status
polymarket bridge status DEPOSIT_ADDRESS

بيانات المحفظة

# View current positions
polymarket data positions YOUR_WALLET_ADDRESS

# View closed positions
polymarket data closed-positions YOUR_WALLET_ADDRESS

# Total portfolio value
polymarket data value YOUR_WALLET_ADDRESS

# Trade history
polymarket data trades YOUR_WALLET_ADDRESS --limit 50

استخدام مخرجات JSON للسكريبتات

تعد ميزة مخرجات JSON إحدى أقوى ميزات Polymarket CLI، مما يجعلها مثالية للسكربتات والأتمتة.

مخرجات JSON الأساسية

# Get markets as JSON
polymarket -o json markets list --limit 10

المخرجات:

[
  {"id": "12345", "question": "Will BTC hit $100k?", "outcomePrices": ["0.67", "0.33"], ...},
  {"id": "67890", "question": "Will ETH flip BTC?", "outcomePrices": ["0.12", "0.88"], ...}
]

الاستخدام مع jq

# Extract just the questions
polymarket -o json markets list --limit 100 | jq '.[].question'

# Get specific price data
polymarket -o json clob midpoint TOKEN_ID | jq '.mid'

# Filter markets by volume
polymarket -o json markets list --limit 100 | jq '.[] | select(.volume_num > 1000000)'

معالجة الأخطاء في السكريبتات

#!/bin/bash
# Example: Check balance with error handling

if ! result=$(polymarket -o json clob balance --asset-type collateral 2>/dev/null); then
  echo "Failed to fetch balance"
  exit 1
fi

balance=$(echo "$result" | jq -r '.balance')
echo "Your balance: $balance USDC"

أتمتة مراقبة السوق

أنشئ مراقب سوق بسيط:

#!/bin/bash
# monitor-market.sh - Monitor a specific market's price

TOKEN_ID=$1
INTERVAL=${2:-60}  # Default 60 seconds

while true; do
  clear
  echo "Monitoring market: $(date)"
  polymarket clob price $TOKEN_ID --side buy
  polymarket clob price $TOKEN_ID --side sell
  echo ""
  polymarket clob book $TOKEN_ID | head -20
  sleep $INTERVAL
done

شغله باستخدام: ./monitor-market.sh TOKEN_ID 30

اختبار واجهة برمجة تطبيقات Polymarket باستخدام Apidog

عند بناء أنظمة تداول آلية أو دمج Polymarket في تطبيقاتك، يعد اختبار واجهة برمجة التطبيقات الشامل أمرًا ضروريًا. يوفر Apidog منصة قوية وشاملة لتطوير واجهة برمجة التطبيقات تجعل اختبار واجهات برمجة تطبيقات أسواق التنبؤ أمرًا مباشرًا وفعالًا.

لماذا تستخدم Apidog لتكامل Polymarket؟

سواء كنت تبني روبوت تداول، أو لوحة تحكم لتحليل السوق، أو تدمج بيانات Polymarket في تطبيقك، يقدم Apidog العديد من المزايا:

عميل واجهة برمجة تطبيقات مرئي: أرسل الطلبات وافحص الاستجابات دون كتابة تعليمات برمجية
اختبار آلي: أنشئ مجموعات اختبار للتحقق من منطق التداول الخاص بك
متغيرات البيئة: إدارة نقاط نهاية واجهة برمجة التطبيقات وبيانات الاعتماد عبر بيئات التطوير/التجهيز/الإنتاج
التعاون: شارك تعريفات واجهة برمجة التطبيقات مع فريقك

وضع واجهة الأوامر التفاعلية

للاستكشاف التفاعلي، استخدم shell المضمن:

polymarket shell

يفتح هذا REPL تفاعليًا:

polymarket> markets list --limit 3
polymarket> clob book TOKEN_ID
polymarket> exit

يدعم الـ shell سجل الأوامر، مما يسهل تجربة أوامر مختلفة.

سير العمل الشائعة

سير العمل 1: البحث والتداول

# Step 1: Find interesting markets
polymarket markets search "bitcoin" --limit 10
polymarket markets get bitcoin-above-100k

# Step 2: Check order book and prices
polymarket clob book TOKEN_ID
polymarket clob price-history TOKEN_ID --interval 1d

# Step 3: Check your balance
polymarket clob balance --asset-type collateral

# Step 4: Place a trade
polymarket clob market-order --token TOKEN_ID --side buy --amount 10

سير العمل 2: إدارة المحفظة

# View all positions
polymarket data positions YOUR_ADDRESS

# Check total value
polymarket data value YOUR_ADDRESS

# View trading history
polymarket data trades YOUR_ADDRESS --limit 50

# Check open orders
polymarket clob orders

سير العمل 3: بوت تداول برمجي

#!/bin/bash
# Simple bot: buy when price drops below threshold

TOKEN_ID="YOUR_TOKEN_ID"
THRESHOLD=0.45
AMOUNT=10

# Get current price
PRICE=$(polymarket -o json clob midpoint $TOKEN_ID | jq -r '.mid')

# Convert to decimal
PRICE_DECIMAL=$(echo "scale=2; $PRICE / 100" | bc)

if (( $(echo "$PRICE_DECIMAL < $THRESHOLD" | bc -l) )); then
  echo "Price ($PRICE_DECIMAL) below threshold ($THRESHOLD) - buying"
  polymarket clob market-order --token $TOKEN_ID --side buy --amount $AMOUNT
else
  echo "Price ($PRICE_DECIMAL) above threshold - holding"
fi

اعتبارات الأمان

عند استخدام Polymarket CLI، ضع في اعتبارك أفضل ممارسات الأمان هذه:

أمان المفتاح الخاص

لا تلتزم أبدًا بمفتاحك الخاص في نظام التحكم بالإصدار
استخدم ملف التكوين بدلاً من متغيرات البيئة في البيئات المشتركة
ضع في اعتبارك تكامل محفظة الأجهزة للمبالغ الكبيرة
استخدم محفظة منفصلة لتداول CLI (ليست محفظتك الرئيسية)

التحقق من المعاملات

تحقق دائمًا من تفاصيل المعاملة قبل التأكيد
ابدأ بمبالغ صغيرة لاختبار إعداداتك
حافظ على رصيد MATIC الخاص بك كافيًا لرسوم الغاز

إدارة مفتاح API

# Create dedicated API keys for scripts
polymarket clob create-api-key

# List and manage keys
polymarket clob api-keys

# Delete compromised keys
polymarket clob delete-api-key

أمان الشبكة

استخدم CLI عبر HTTPS (افتراضي)
كن حذرًا عند استخدام المفاتيح الخاصة في البيئات السحابية
ضع في اعتبارك استخدام VPN عند التداول من الشبكات العامة

الخلاصة

Polymarket CLI هي أداة قوية للمطورين الذين يرغبون في التفاعل مع أسواق التنبؤ برمجيًا. سواء كنت متداولًا يسعى لأتمتة الاستراتيجيات، أو باحثًا يحلل بيانات السوق، أو مطورًا يبني روبوتات تداول، توفر واجهة سطر الأوامر واجهة قوية لنظام Polymarket البيئي.

النقاط الرئيسية من هذا الدليل:

ثبّت عبر Homebrew أو سكريبت shell لإعداد سريع
تصفح الأسواق بدون محفظة للبحث
قم بتكوين محفظتك بشكل صحيح قبل التداول
استخدم مخرجات JSON للسكربتات والأتمتة
أعط الأولوية دائمًا للأمان عند التعامل مع المفاتيح الخاصة
ابدأ بصفقات صغيرة لاختبار إعدادك
استخدم Apidog لاختبار صلاحية تكاملات Polymarket API الخاصة بك

بالنسبة لحالات الاستخدام الأكثر تقدمًا، فكر في دمج Polymarket CLI مع أدوات أخرى مثل cron للمهام المجدولة، أو jq لمعالجة البيانات، أو روبوتات مخصصة مبنية بلغة Python أو Node.js. عند بناء تكامل التداول الخاص بك، استخدم Apidog لاختبار جميع نقاط نهاية واجهة برمجة التطبيقات بدقة قبل البدء الفعلي.

جرب Apidog مجانًا لتبسيط سير عمل اختبار واجهة برمجة التطبيقات الخاص بك وبناء الثقة في تكاملات Polymarket الخاصة بك.

زر

الأسئلة الشائعة

هل Polymarket CLI آمن للاستخدام؟

Polymarket CLI هو برنامج تجريبي. استخدمه بحذر ولا تستخدمه أبدًا مع مبالغ كبيرة من الأموال. تحقق دائمًا من المعاملات قبل التأكيد. المشروع مفتوح المصدر، لذا يمكنك مراجعة الكود بنفسك.

هل أحتاج إلى محفظة لتصفح الأسواق؟

لا. تعمل معظم الأوامر (الأسواق، الأحداث، أسعار CLOB، دفاتر الطلبات) بدون محفظة. تحتاج فقط إلى محفظة لوضع الأوامر، والتحقق من الأرصدة، والعمليات على السلسلة.

ما هي سلاسل الكتل التي يدعمها Polymarket؟

Polymarket مبني على Polygon (معرف السلسلة 137). يتعامل CLI مع كل من العمليات على السلسلة (التي تتطلب MATIC لرسوم الغاز) ووضع الأوامر خارج السلسلة.

هل يمكنني استخدام Polymarket CLI للتداول الآلي؟

نعم. يجعل تنسيق مخرجات JSON منه مثاليًا للسكربتات. يمكنك بناء روبوتات تداول آلية باستخدام سكريبتات shell، أو Python، أو أي لغة يمكنها تنفيذ أوامر CLI وتحليل JSON.

كيف أحصل على مساعدة بخصوص Polymarket CLI؟

تحقق من مستودع GitHub الرسمي للوثائق وتتبع المشكلات.

هل يدعم Polymarket CLI شبكة الاختبار (testnet)؟

يعمل الإصدار الحالي مع نشر Polymarket الرئيسي. للحصول على دعم شبكة الاختبار، تحقق من مستودع GitHub للحصول على أحدث المعلومات.

ما الفرق بين أنواع التوقيع proxy و eoa؟

يستخدم proxy (الافتراضي) نظام محفظة Polymarket الوكيل، والذي يمكن أن يقلل من تكاليف الغاز. يوقع eoa مباشرة باستخدام مفتاحك الخاص. لمعظم المستخدمين، يوصى بنوع الوكيل الافتراضي.

كيف أقوم بتحديث Polymarket CLI إلى أحدث إصدار؟

قم بتشغيل polymarket upgrade للتحقق من التحديثات وتثبيتها. لتثبيتات Homebrew، استخدم brew update && brew upgrade polymarket.

هل يمكنني استخدام Apidog لاختبار مكالمات Polymarket API؟

نعم. Apidog هي أداة ممتازة لاختبار واجهات برمجة تطبيقات أسواق التنبؤ. أنشئ مشروعًا جديدًا في Apidog، وأضف نقاط نهاية Polymarket الخاصة بك، واستخدم العميل المرئي لإرسال الطلبات وفحص الاستجابات. تجعل متغيرات البيئة في Apidog من السهل إدارة بيانات اعتماد واجهة برمجة التطبيقات المختلفة، ويمكنك إنشاء سيناريوهات اختبار آلية للتحقق من أن منطق التداول الخاص بك يعمل بشكل صحيح.