الأسواق المدعومة

تعرّف على الأصول والأطر الزمنية ومخططات البيانات وسياسات الإتاحة المتوفرة عبر PolyTest API.

الأصول والأطر الزمنية

عدد الأصول: 6

تتتبع PolyTest أسواق التنبؤات لكل أصل على Polymarket. يدعم كل أصل مجموعة فرعية من الأطر الزمنية للأسواق (المدة من الافتتاح حتى الحسم). تُلتقط اللقطات بمعدل 8× في الثانية على جميع الأطر الزمنية. استخدم coin وmarket_type للتصفية في API.

الأصل	معامل API	الأطر الزمنية	تردد اللقطات
BTC Bitcoin `coin="btc"`	`coin="btc"`	5m15m1hr4hr24hr	8×/ثانية
ETH Ethereum `coin="eth"`	`coin="eth"`	5m15m1hr	8×/ثانية
SOL Solana `coin="sol"`	`coin="sol"`	5m15m1hr	8×/ثانية
XRP XRP قريبًا جارٍ جمع البيانات `coin="xrp"`	`coin="xrp"`	5m15m1hr4hr24hr	8×/ثانية
DOGE Dogecoin قريبًا جارٍ جمع البيانات `coin="doge"`	`coin="doge"`	5m15m1hr4hr24hr	8×/ثانية
BNB BNB قريبًا جارٍ جمع البيانات `coin="bnb"`	`coin="bnb"`	5m15m1hr4hr24hr	8×/ثانية

~عدد اللقطات لكل سوق = المدة × 8 (مثلًا 5m ≈ 2,400، و24h ≈ 691,200).

إتاحة البيانات

تعتمد إتاحة البيانات على خطتك: تغطي خطة Builder (والفترة التجريبية المجانية لمدة 3 أيام التي تتضمنها كاملة) نافذة حديثة، بينما تتيح خطتا Pro وEnterprise وصولًا غير محدود إلى البيانات التاريخية. في الاستعلامات حسب النطاق، يدعم كل طلب نافذة أقصاها 31 يومًا.

Builder

14 يومًا

وصول إلى نحو 14 يومًا من بيانات الأسواق واللقطات التاريخية — بما في ذلك خلال الفترة التجريبية المجانية لمدة 3 أيام.

Pro

شائع

غير محدود

وصول كامل إلى البيانات التاريخية.

Enterprise

غير محدود

وصول تاريخي كامل بالإضافة إلى سياسات مخصصة لإتاحة البيانات وعمليات تصدير مجمّعة.

الحد الأقصى لنافذة البيانات: المدى من start_time إلى end_time محدود بـ 31 يومًا. وتُحذف البيانات الأقدم بعد 31 يومًا.

مخطط كائن السوق

يحتوي كل سوق تُرجعه API على الحقول التالية.

الحقل	النوع	الوصف
`market_id`	`string`	معرّف رقمي فريد للسوق
`event_id`	`string`	معرّف الحدث الأصلي على Polymarket
`slug`	`string`	slug مقروء لعنوان URL (مثل btc-updown-5m-1772689200)
`market_type`	`string`	نوع المدة: 5m \| 15m \| 1h \| 4h \| 24h
`coin`	`string`	العملة المشفرة: btc \| eth \| sol \| xrp \| doge \| bnb
`start_time`	`ISO 8601`	وقت افتتاح السوق للتداول
`end_time`	`ISO 8601`	وقت حسم السوق
`price_start`	`number`	السعر الفوري للأصل عند افتتاح السوق
`price_end`	`number \| null`	السعر الفوري للأصل عند إغلاق السوق (null إذا لم يُحسم)
`winner`	`string \| null`	النتيجة: "Up" أو "Down" (null إذا لم يُحسم)
`final_volume`	`number`	إجمالي حجم التداول في السوق
`final_liquidity`	`number`	إجمالي السيولة عند إغلاق السوق
`condition_id`	`string`	معرّف الشرط على السلسلة
`clob_token_up`	`string`	معرّف توكن CLOB لنتيجة "Up"
`clob_token_down`	`string`	معرّف توكن CLOB لنتيجة "Down"
`resolved_at`	`ISO 8601 \| null`	الطابع الزمني لحسم السوق
`created_at`	`ISO 8601`	وقت إنشاء السجل في PolyTest
`updated_at`	`ISO 8601`	الطابع الزمني لآخر تحديث

مخطط كائن اللقطة

تلتقط اللقطات حالة السوق عند لحظة زمنية محددة، بما في ذلك الأسعار والاحتمالات وعمق دفتر الأوامر الاختياري.

الحقل	النوع	الوصف
`id`	`integer`	معرّف فريد للصف
`market_id`	`string`	معرّف السوق الأصلي (مفتاح خارجي)
`time`	`ISO 8601`	الطابع الزمني لهذه اللقطة
`spot_price`	`number \| null`	السعر الفوري للأصل وقت اللقطة
`price_up`	`number \| null`	احتمال نتيجة "Up" (⁦0.00–1.00⁩)
`price_down`	`number \| null`	احتمال نتيجة "Down" (⁦0.00–1.00⁩)
`orderbook_up`	`object \| null`	دفتر الأوامر الكامل لتوكن "Up" (عند الطلب)
`orderbook_down`	`object \| null`	دفتر الأوامر الكامل لتوكن "Down" (عند الطلب)

حقول دفتر الأوامر لا تُضمَّن إلا عندما تمرر include_orderbook=true في طلبك. بيانات دفتر الأوامر متاحة في خطط Builder وPro وEnterprise فقط.

كيف تعمل الأسواق

يمثل كل سوق تنبؤًا ثنائيًا: هل سيتحرك سعر عملة مشفرة معيّنة Up أم Down خلال الإطار الزمني للسوق؟

دورة حياة السوق

1يُفتتح السوق — تُضبط قيمة start_time ويبدأ التداول
2تُلتقط اللقطات 8×/ثانية — وتتحدث أسعار الاحتمالات في الوقت الفعلي
3يُحسم السوق — تُضبط قيمة winner على "Up" أو "Down"
4تُؤرشف البيانات — وتبقى اللقطات قابلة للاستعلام عبر API

أسعار الاحتمالات

يمثل price_up وprice_down الاحتمالات الضمنية في السوق من 0.00 إلى 1.00.

القيمة price_up = 0.65 تعني أن السوق يمنح احتمالًا بنسبة 65% لأن يكون سعر الأصل أعلى وقت الحسم.

تُشتق هذه الأسعار من دفتر أوامر Polymarket وتتحدث مع كل لقطة.