v0.2.0-beta

OpenAPI 3.1.0

الحصول على أسواق Kalshi

Felo API Support

MIT

الخادم

https://openapi.felo.ai

مكتبات العملاء

Shell Curl

Kalshi

Prediction-market data.

Kalshi العمليات

get/v1/beta/kalshi/markets

الحصول على أسواق Kalshi

اسرد أسواق التوقّعات باستخدام مرشّحات status وticker وevent وseries والطوابع الزمنية الموثّقة. يتضمّن العقد max_updated_ts لكنه لا يعلن عن معامل بحث نصّي حر. اتبع مخطط الاستجابة لسجلات الأسواق وترقيم الصفحات.

مرجع التسعير

القياس: أساس تكلفة ثابت لكل طلب ناجح.
تقدير الطلب المرجعي: 0.02 دولار أمريكي.

بيانات وصفية مرجعية فقط، وليست عرض سعر للحساب ولا سعرًا مضمونًا ولا حدًا للإنفاق. أرصدة الموارد ليست أرصدة Felo. تتبع الرسوم النهائية سجلات فوترة Felo.

معاملات الاستعلام

cursor
النوع: string

مؤشر ترقيم الصفحات. استخدم قيمة المؤشر المعادة من الاستجابة السابقة للحصول على الصفحة التالية من النتائج. اتركه فارغًا للصفحة الأولى.
event_ticker
النوع: string

رمز الحدث المراد التصفية به. يُدعم رمز حدث واحد فقط.
limit
النوع: integer التنسيق: int64
الحد الأدنى:
0
الحد الأقصى:
1000

عدد النتائج لكل صفحة. القيمة الافتراضية 100. الحد الأقصى 1000.
max_close_ts
النوع: integer التنسيق: int64

تصفية العناصر التي تُغلق قبل هذا الطابع الزمني Unix
max_created_ts
النوع: integer التنسيق: int64

تصفية العناصر التي أُنشئت قبل هذا الطابع الزمني Unix
max_settled_ts
النوع: integer التنسيق: int64

تصفية العناصر التي جرى تسويتها قبل هذا الطابع الزمني Unix
max_updated_ts
النوع: integer التنسيق: int64

إرجاع الأسواق التي حُدّثت بياناتها الوصفية عند هذا الطابع الزمني Unix أو قبله (بالثواني). يتتبع التغييرات غير المتعلقة بالتداول فقط. يمكن دمجه مع min_updated_ts وmve_filter=exclude. يمكن أيضًا دمجه مع series_ticker، الذي يتطلب mve_filter=exclude. غير متوافق مع المرشّحات الأخرى.
min_close_ts
النوع: integer التنسيق: int64

تصفية العناصر التي تُغلق بعد هذا الطابع الزمني Unix
min_created_ts
النوع: integer التنسيق: int64

تصفية العناصر التي أُنشئت بعد هذا الطابع الزمني Unix
min_settled_ts
النوع: integer التنسيق: int64

تصفية العناصر التي جرى تسويتها بعد هذا الطابع الزمني Unix
min_updated_ts
النوع: integer التنسيق: int64

إرجاع الأسواق التي حُدّثت بياناتها الوصفية بعد هذا الطابع الزمني Unix (بالثواني). يتتبع التغييرات غير المتعلقة بالتداول فقط. يمكن دمجه مع max_updated_ts وmve_filter=exclude. يمكن أيضًا دمجه مع series_ticker، الذي يتطلب mve_filter=exclude. غير متوافق مع المرشّحات الأخرى.
mve_filter
النوع: string تعداد

تصفية حسب الأحداث متعددة المتغيرات (التركيبات). 'only' يعيد الأحداث متعددة المتغيرات فقط، و'exclude' يستبعدها.
القيم
- only
- exclude
series_ticker
النوع: string

تصفية حسب رمز السلسلة
status
النوع: string تعداد

تصفية حسب حالة السوق. اتركه فارغًا لإرجاع الأسواق بأي حالة.
القيم
- unopened
- open
- paused
- closed
- settled
tickers
النوع: string

تصفية حسب رموز أسواق محددة. قائمة رموز الأسواق المراد استرجاعها مفصولة بفواصل.

الاستجابات

200
النوع: object · Response24B585A0A861_GetMarketsResponse

تم استرداد الأسواق بنجاح
cursor
النوع: string
مطلوب
markets
النوع: array object[] · Response24B585A0A861_Market[]
مطلوب
can_close_early
النوع: boolean
مطلوب
close_time
النوع: string التنسيق: date-time
مطلوب

the date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z

created_time
النوع: string التنسيق: date-time
مطلوب

the date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z

event_ticker
النوع: string
مطلوب
expiration_value
النوع: string
مطلوب

القيمة التي جرى أخذها في الاعتبار للتسوية

last_price_dollars
النوع: string · Response24B585A0A861_FixedPointDollars
مطلوب

سلسلة دولار أمريكي بنقطة ثابتة. تقبل معظم حقول الطلب من 2 إلى 4 خانات عشرية (مثل "0.56"، "0.5600")؛ وتُخرج الاستجابات حتى 6. فواصل الأسعار الصالحة لسوق معين مقيّدة بهيكل مستويات الأسعار لذلك السوق.

latest_expiration_time
النوع: string التنسيق: date-time
مطلوب

أحدث وقت ممكن لانتهاء هذا السوق

market_type
النوع: string تعداد
مطلوب

يحدد نوع السوق

القيم
binary
scalar
no_ask_dollars
النوع: string · Response24B585A0A861_FixedPointDollars
مطلوب

سلسلة دولار أمريكي بنقطة ثابتة. تقبل معظم حقول الطلب من 2 إلى 4 خانات عشرية (مثل "0.56"، "0.5600")؛ وتُخرج الاستجابات حتى 6. فواصل الأسعار الصالحة لسوق معين مقيّدة بهيكل مستويات الأسعار لذلك السوق.

no_bid_dollars
النوع: string · Response24B585A0A861_FixedPointDollars
مطلوب

سلسلة دولار أمريكي بنقطة ثابتة. تقبل معظم حقول الطلب من 2 إلى 4 خانات عشرية (مثل "0.56"، "0.5600")؛ وتُخرج الاستجابات حتى 6. فواصل الأسعار الصالحة لسوق معين مقيّدة بهيكل مستويات الأسعار لذلك السوق.

no_sub_title
النوع: string
مطلوب

عنوان مختصر لجهة no في هذا السوق

notional_value_dollars
النوع: string · Response24B585A0A861_FixedPointDollars
مطلوب

سلسلة دولار أمريكي بنقطة ثابتة. تقبل معظم حقول الطلب من 2 إلى 4 خانات عشرية (مثل "0.56"، "0.5600")؛ وتُخرج الاستجابات حتى 6. فواصل الأسعار الصالحة لسوق معين مقيّدة بهيكل مستويات الأسعار لذلك السوق.

open_interest_fp
النوع: string · Response24B585A0A861_FixedPointCount
مطلوب

سلسلة عدد عقود بنقطة ثابتة (رقمان عشريان، مثل "10.00"؛ يُشار إليها بـ"fp" في أسماء الحقول). تقبل الطلبات من 0 إلى 2 خانة عشرية (مثل "10"، "10.0"، "10.00")؛ وتُخرج الاستجابات دائمًا رقمين عشريين. تُدعم قيم العقود الكسرية (مثل "2.50")؛ والحد الأدنى للدقة هو 0.01 عقد.

open_time
النوع: string التنسيق: date-time
مطلوب

the date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z

previous_price_dollars
النوع: string · Response24B585A0A861_FixedPointDollars
مطلوب

سلسلة دولار أمريكي بنقطة ثابتة. تقبل معظم حقول الطلب من 2 إلى 4 خانات عشرية (مثل "0.56"، "0.5600")؛ وتُخرج الاستجابات حتى 6. فواصل الأسعار الصالحة لسوق معين مقيّدة بهيكل مستويات الأسعار لذلك السوق.

previous_yes_ask_dollars
النوع: string · Response24B585A0A861_FixedPointDollars
مطلوب

سلسلة دولار أمريكي بنقطة ثابتة. تقبل معظم حقول الطلب من 2 إلى 4 خانات عشرية (مثل "0.56"، "0.5600")؛ وتُخرج الاستجابات حتى 6. فواصل الأسعار الصالحة لسوق معين مقيّدة بهيكل مستويات الأسعار لذلك السوق.

previous_yes_bid_dollars
النوع: string · Response24B585A0A861_FixedPointDollars
مطلوب

سلسلة دولار أمريكي بنقطة ثابتة. تقبل معظم حقول الطلب من 2 إلى 4 خانات عشرية (مثل "0.56"، "0.5600")؛ وتُخرج الاستجابات حتى 6. فواصل الأسعار الصالحة لسوق معين مقيّدة بهيكل مستويات الأسعار لذلك السوق.

price_level_structure
النوع: string
مطلوب

هيكل مستويات الأسعار لهذا السوق، الذي يحدد نطاقات الأسعار وأحجام الخطوات

price_ranges
النوع: array object[] · Response24B585A0A861_PriceRange[]
مطلوب

نطاقات الأسعار الصالحة للأوامر في هذا السوق

end
النوع: string
مطلوب

سعر النهاية لهذا النطاق بالدولار

start
النوع: string
مطلوب

سعر البداية لهذا النطاق بالدولار

step
النوع: string
مطلوب

خطوة السعر/حجم التيك لهذا النطاق بالدولار

result
النوع: string تعداد
مطلوب
القيم
yes
no
scalar
rules_primary
النوع: string
مطلوب

وصف باللغة العادية لأهم شروط السوق

rules_secondary
النوع: string
مطلوب

وصف باللغة العادية لشروط السوق الثانوية

settlement_bounds_type
النوع: string تعداد
مطلوب

حدود التسوية التي تنطبق على هذا السوق. default تعني أن السوق ليس له حدود تسوية

القيم
default
floor
settlement_timer_seconds
النوع: integer
مطلوب

المدة التي تنقضي بعد الحسم حتى تتم تسوية السوق

status
النوع: string تعداد
مطلوب

الحالة الحالية للسوق في دورة حياته.

القيم
initialized
inactive
active
closed
determined
disputed
amended
finalized
ticker
النوع: string
مطلوب
updated_time
النوع: string التنسيق: date-time
مطلوب

وقت آخر تحديث للبيانات الوصفية غير المتعلقة بالتداول.

volume_24h_fp
النوع: string · Response24B585A0A861_FixedPointCount
مطلوب

سلسلة عدد عقود بنقطة ثابتة (رقمان عشريان، مثل "10.00"؛ يُشار إليها بـ"fp" في أسماء الحقول). تقبل الطلبات من 0 إلى 2 خانة عشرية (مثل "10"، "10.0"، "10.00")؛ وتُخرج الاستجابات دائمًا رقمين عشريين. تُدعم قيم العقود الكسرية (مثل "2.50")؛ والحد الأدنى للدقة هو 0.01 عقد.

volume_fp
النوع: string · Response24B585A0A861_FixedPointCount
مطلوب

سلسلة عدد عقود بنقطة ثابتة (رقمان عشريان، مثل "10.00"؛ يُشار إليها بـ"fp" في أسماء الحقول). تقبل الطلبات من 0 إلى 2 خانة عشرية (مثل "10"، "10.0"، "10.00")؛ وتُخرج الاستجابات دائمًا رقمين عشريين. تُدعم قيم العقود الكسرية (مثل "2.50")؛ والحد الأدنى للدقة هو 0.01 عقد.

yes_ask_dollars
النوع: string · Response24B585A0A861_FixedPointDollars
مطلوب

سلسلة دولار أمريكي بنقطة ثابتة. تقبل معظم حقول الطلب من 2 إلى 4 خانات عشرية (مثل "0.56"، "0.5600")؛ وتُخرج الاستجابات حتى 6. فواصل الأسعار الصالحة لسوق معين مقيّدة بهيكل مستويات الأسعار لذلك السوق.

yes_ask_size_fp
النوع: string · Response24B585A0A861_FixedPointCount
مطلوب

سلسلة عدد عقود بنقطة ثابتة (رقمان عشريان، مثل "10.00"؛ يُشار إليها بـ"fp" في أسماء الحقول). تقبل الطلبات من 0 إلى 2 خانة عشرية (مثل "10"، "10.0"، "10.00")؛ وتُخرج الاستجابات دائمًا رقمين عشريين. تُدعم قيم العقود الكسرية (مثل "2.50")؛ والحد الأدنى للدقة هو 0.01 عقد.

yes_bid_dollars
النوع: string · Response24B585A0A861_FixedPointDollars
مطلوب

سلسلة دولار أمريكي بنقطة ثابتة. تقبل معظم حقول الطلب من 2 إلى 4 خانات عشرية (مثل "0.56"، "0.5600")؛ وتُخرج الاستجابات حتى 6. فواصل الأسعار الصالحة لسوق معين مقيّدة بهيكل مستويات الأسعار لذلك السوق.

yes_bid_size_fp
النوع: string · Response24B585A0A861_FixedPointCount
مطلوب

سلسلة عدد عقود بنقطة ثابتة (رقمان عشريان، مثل "10.00"؛ يُشار إليها بـ"fp" في أسماء الحقول). تقبل الطلبات من 0 إلى 2 خانة عشرية (مثل "10"، "10.0"، "10.00")؛ وتُخرج الاستجابات دائمًا رقمين عشريين. تُدعم قيم العقود الكسرية (مثل "2.50")؛ والحد الأدنى للدقة هو 0.01 عقد.

yes_sub_title
النوع: string
مطلوب

عنوان مختصر لجانب «نعم» في هذا السوق

cap_strike
النوع: number | null التنسيق: double

الحد الأقصى لقيمة الانتهاء المؤدية إلى تسوية YES

custom_strike
النوع: object | null

قيمة الانتهاء لكل هدف تؤدي إلى تسوية YES

early_close_condition
النوع: string | null

الشرط الذي بموجبه يمكن للسوق الإغلاق مبكرًا

exchange_index
النوع: integer · Response24B585A0A861_ExchangeIndex

معرّف لشريحة تداول.

expected_expiration_time
النوع: string | null التنسيق: date-time

الوقت الذي يُتوقع أن ينتهي فيه هذا السوق

expiration_time
النوع: string التنسيق: date-time
مهمل

the date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z

fee_waiver_expiration_time
النوع: string | null التنسيق: date-time

الوقت الذي تنتهي فيه إعفاءات رسوم هذا السوق

floor_strike
النوع: number | null التنسيق: double

الحد الأدنى لقيمة الانتهاء المؤدية إلى تسوية YES

functional_strike
النوع: string | null

تعيين من قيم الانتهاء إلى قيم التسوية

is_provisional
النوع: boolean

إذا كانت true، فقد يُزال السوق بعد التحديد إذا لم يكن هناك نشاط عليه

mve_collection_ticker
النوع: string

رمز مجموعة الأحداث متعددة المتغيرات

mve_selected_legs
النوع: array object[] · Response24B585A0A861_MveSelectedLeg[]
event_ticker
النوع: string

معرّف فريد للحدث المحدد

market_ticker
النوع: string

معرّف فريد للسوق المحدد

side
النوع: string

جانب السوق المحدد

yes_settlement_value_dollars
النوع: string · Response24B585A0A861_FixedPointDollars

سلسلة دولار أمريكي بنقطة ثابتة. تقبل معظم حقول الطلب من 2 إلى 4 خانات عشرية (مثل "0.56"، "0.5600")؛ وتُخرج الاستجابات حتى 6. فواصل الأسعار الصالحة لسوق معين مقيّدة بهيكل مستويات الأسعار لذلك السوق.

occurrence_datetime
النوع: string | null التنسيق: date-time

التاريخ والوقت المسجّلان لحدوث الحدث الأساسي، عند توفرهما

primary_participant_key
النوع: string | null
settlement_floor_dollars
النوع: string · Response24B585A0A861_FixedPointDollars

سلسلة دولار أمريكي بنقطة ثابتة. تقبل معظم حقول الطلب من 2 إلى 4 خانات عشرية (مثل "0.56"، "0.5600")؛ وتُخرج الاستجابات حتى 6. فواصل الأسعار الصالحة لسوق معين مقيّدة بهيكل مستويات الأسعار لذلك السوق.

settlement_ts
النوع: string | null التنسيق: date-time

الطابع الزمني لتسوية السوق. يُملأ فقط للأسواق المسوّاة

settlement_value_dollars
النوع: string · Response24B585A0A861_FixedPointDollars

سلسلة دولار أمريكي بنقطة ثابتة. تقبل معظم حقول الطلب من 2 إلى 4 خانات عشرية (مثل "0.56"، "0.5600")؛ وتُخرج الاستجابات حتى 6. فواصل الأسعار الصالحة لسوق معين مقيّدة بهيكل مستويات الأسعار لذلك السوق.

strike_type
النوع: string تعداد

يحدد نوع حد التنفيذ كيفية تعريف حد السوق وتقييمه

القيم
greater
greater_or_equal
less
less_or_equal
between
functional
custom
structured
subtitle
النوع: string
مهمل
title
النوع: string
مهمل
application/json
400

تعذّرت معالجة الطلب. تحقق من معاملات الطلب.
401

مطلوب مفتاح API صالح من Felo.
402

لا يمكن متابعة الطلب لأن أحد متطلبات الفوترة غير مستوفٍ.
403

الحساب غير مصرّح له بهذه العملية.
429

تم بلوغ حد الطلبات أو حد الإنفاق.
502

تعذّر على الخدمة إكمال الطلب.
503

خدمة API أو الفوترة غير متاحة مؤقتًا.
504

انتهت مهلة الخدمة أثناء معالجة الطلب.
default

استجابة خطأ؛ قد تستخدم استجابات المنبع الممرَّرة تنسيقات المزوّد

application/json

get/v1/beta/kalshi/markets

curl https://openapi.felo.ai/v1/beta/kalshi/markets \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

عرض المخطط

{
  "markets": [
    {
      "ticker": "string",
      "event_ticker": "string",
      "market_type": "binary",
      "yes_sub_title": "string",
      "no_sub_title": "string",
      "created_time": "2026-10-26T08:08:16.601Z",
      "updated_time": "2026-10-26T08:08:16.601Z",
      "open_time": "2026-10-26T08:08:16.601Z",
      "close_time": "2026-10-26T08:08:16.601Z",
      "expected_expiration_time": null,
      "latest_expiration_time": "2026-10-26T08:08:16.601Z",
      "settlement_timer_seconds": 1,
      "status": "initialized",
      "yes_bid_dollars": "0.5600",
      "yes_bid_size_fp": "10.00",
      "yes_ask_dollars": "0.5600",
      "yes_ask_size_fp": "10.00",
      "no_bid_dollars": "0.5600",
      "no_ask_dollars": "0.5600",
      "last_price_dollars": "0.5600",
      "volume_fp": "10.00",
      "volume_24h_fp": "10.00",
      "result": "yes",
      "can_close_early": true,
      "open_interest_fp": "10.00",
      "notional_value_dollars": "0.5600",
      "previous_yes_bid_dollars": "0.5600",
      "previous_yes_ask_dollars": "0.5600",
      "previous_price_dollars": "0.5600",
      "settlement_value_dollars": "0.5600",
      "settlement_ts": null,
      "settlement_bounds_type": "default",
      "settlement_floor_dollars": "0.5600",
      "expiration_value": "string",
      "occurrence_datetime": null,
      "fee_waiver_expiration_time": null,
      "early_close_condition": null,
      "strike_type": "greater",
      "floor_strike": null,
      "cap_strike": null,
      "functional_strike": null,
      "custom_strike": null,
      "rules_primary": "string",
      "rules_secondary": "string",
      "mve_collection_ticker": "string",
      "mve_selected_legs": [
        {
          "event_ticker": "string",
          "market_ticker": "string",
          "side": "string",
          "yes_settlement_value_dollars": "0.5600"
        }
      ],
      "primary_participant_key": null,
      "price_level_structure": "string",
      "price_ranges": [
        {
          "start": "string",
          "end": "string",
          "step": "string"
        }
      ],
      "is_provisional": true,
      "exchange_index": 0
    }
  ],
  "cursor": "string"
}

تم استرداد الأسواق بنجاح

الحصول على أسواق Kalshi

المصادقةRequired

Kalshi

الحصول على أسواق Kalshi

مرجع التسعير