Felo API PlatformFelo API Platform
جميع endpoints الخاصة بـ Kalshi
v0.2.0-beta
OpenAPI 3.1.0

الحصول على تداولات Kalshi

Felo API Support
MIT
الخادم:https://openapi.felo.ai
مكتبات العملاء
Shell Curl

Kalshi

​

Prediction-market data.

Kalshi العمليات

الحصول على تداولات Kalshi

​

احصل على سجل التداولات المنفّذة لأسواق Kalshi — عمليات تنفيذ فعلية، لا عروض أسعار. استخدمه عندما تحتاج إلى الأسعار المحقّقة والحجم المتداول خلال نافذة زمنية، مثلًا لمعرفة كيف تحرّكت القناعة أثناء تطوّر حدث؛ ضيّق النطاق باستخدام ticker ونطاق الثواني Unix min_ts / max_ts، واضبط is_block_trade لعزل الصفقات الكبيرة المتفاوض عليها. يعيد trades[] مع trade_id وticker وcount_fp (العقود) وyes_price_dollars / no_price_dollars وtaker_side وcreated_time، إضافةً إلى cursor للتنقّل بين الصفحات. للحصول على العروض الحالية وقواعد التسوية وبيانات السوق الوصفية بدلًا من عمليات التنفيذ، استخدم get_kalshi_markets.

مرجع التسعير

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

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

معاملات الاستعلام
  • cursor
    النوع: string

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

  • is_block_trade
    النوع: boolean

    تصفية التداولات حسب كونها تداولات كتلية. احذفه لإرجاع كل التداولات. اضبطه على true لإرجاع التداولات الكتلية فقط. اضبطه على false لإرجاع التداولات غير الكتلية فقط.

  • limit
    النوع: integer التنسيق: int64
    الحد الأدنى:  
    0
    الحد الأقصى:  
    1000

    عدد النتائج لكل صفحة. القيمة الافتراضية 100. الحد الأقصى 1000.

  • max_ts
    النوع: integer التنسيق: int64

    تصفية العناصر قبل هذا الطابع الزمني Unix

  • min_ts
    النوع: integer التنسيق: int64

    تصفية العناصر بعد هذا الطابع الزمني Unix

  • ticker
    النوع: string

    تصفية حسب رمز السوق

الاستجابات
  • 200
    النوع: object · Response24B585A0A861_GetTradesResponse

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

    • cursor
      النوع: string
      مطلوب
    • trades
      النوع: array object[] · Response24B585A0A861_Trade[]
      مطلوب
      • count_fp
        النوع: string · Response24B585A0A861_FixedPointCount
        مطلوب

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

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

        الطابع الزمني لتنفيذ هذه الصفقة

      • is_block_trade
        النوع: boolean
        مطلوب

        True إذا طوبقت هذه الصفقة خارج دفتر الأوامر كصفقة كتلة (مثلًا عبر RFQ / عرض كتلة تفاوضي)؛ وfalse للصفقات المنفذة على دفتر الأوامر القياسي.

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

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

      • taker_book_side
        النوع: string · Response24B585A0A861_BookSideتعداد
        مطلوب

        جهة دفتر الطلبات لأمر أو تداول. بالنسبة لأسواق الأحداث، يشير هذا إلى جهة YES فقط: bid تعني شراء YES، وask تعني بيع YES. (بيع YES مكافئ اقتصاديًا لشراء NO بسعر 1 - price، لكن هذه النقطة الطرفية تسعّر كل شيء من جهة YES.)

        القيم
        • bid
        • ask
      • taker_outcome_side
        النوع: string تعداد
        مطلوب

        جانب النتيجة الذي يتمركز فيه الآخذ. ينتج buy-yes و sell-no القيمة 'yes'؛ وينتج buy-no و sell-yes القيمة 'no'.

        يصف taker_outcome_side التعرّض الاتجاهي فقط؛ ولا يغيّر سعر الصفقة. تُطابَق صفقة عند السعر p مع taker_outcome_side=no مع صانع السوق عند السعر نفسه p وفي الاتجاه المعاكس — ويتداول الطرفان بالسعر نفسه.

        سيصبح taker_outcome_side و taker_book_side الطريقة المعتمدة لتحديد اتجاه الصفقة. سيُهمَل الحقل القديم taker_side في إصدار مستقبلي — يُرجى الانتقال إلى هذه الحقول الجديدة.

        القيم
        • yes = TradeTakerOutcomeSideYes
        • no = TradeTakerOutcomeSideNo
      • ticker
        النوع: string
        مطلوب

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

      • trade_id
        النوع: string
        مطلوب

        معرّف فريد لهذه الصفقة

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

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

      • taker_side
        النوع: string تعداد
        مهمل

        مهمَل. استخدم taker_outcome_side (أو taker_book_side) بدلًا منه. راجع اتجاه الطلب. لن يُزال هذا الحقل قبل 14 مايو 2026.

        القيم
        • yes = TradeTakerSideYes
        • no = TradeTakerSideNo
    application/json
  • 400

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

  • 401

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

  • 402

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

  • 403

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

  • 429

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

  • 502

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

  • 503

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

  • 504

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

  • default

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

    application/json
Request Example for get/v1/beta/kalshi/trades
curl https://openapi.felo.ai/v1/beta/kalshi/trades \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "trades": [
    {
      "trade_id": "string",
      "ticker": "string",
      "count_fp": "10.00",
      "yes_price_dollars": "0.5600",
      "no_price_dollars": "0.5600",
      "taker_outcome_side": "yes",
      "taker_book_side": "bid",
      "created_time": "2026-10-26T08:08:16.678Z",
      "is_block_trade": true
    }
  ],
  "cursor": "string"
}

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

Get Kalshi Trades