الانتقال إلى المحتوى الرئيسي
GET
/
api
/
v2.1
/
calendar
/
splits
يُرجِع بيانات calendar لتجزئات الأسهم
curl --request GET \
  --url 'https://api.benzinga.com/api/v2.1/calendar/splits?token=' \
  --header 'accept: <accept>'
{
  "splits": [
    {
      "cusip": "87807D509",
      "date_announced": "2025-12-30",
      "date_distribution": "2025-01-06",
      "date_ex": "2025-01-07",
      "date_recorded": "2025-01-02",
      "exchange": "NASDAQ",
      "id": "677675329a903000017cb6f1",
      "importance": 1,
      "name": "TC BioPharm (Holdings)",
      "notes": "",
      "optionable": false,
      "ratio": "1.25:1",
      "split_type": "ADR Ratio Change",
      "ticker": "TCBP",
      "updated": 1735816783
    }
  ]
}

{
  "splits": [
    {
      "cusip": "87807D509",
      "date_announced": "2025-12-30",
      "date_distribution": "2025-01-06",
      "date_ex": "2025-01-07",
      "date_recorded": "2025-01-02",
      "exchange": "NASDAQ",
      "id": "677675329a903000017cb6f1",
      "importance": 1,
      "name": "TC BioPharm (Holdings)",
      "notes": "",
      "optionable": false,
      "ratio": "1.25:1",
      "split_type": "ADR Ratio Change",
      "ticker": "TCBP",
      "updated": 1735816783
    }
  ]
}

التفويضات

​
token
string
query
مطلوب

الترويسات

​
accept
enum<string>
افتراضي:application/json
مطلوب

يحدّد تنسيق الإخراج. تعمل معاملات الاستعلام بالطريقة نفسها لكلا التنسيقين

الخيارات المتاحة:
application/json

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

​
page
integer
افتراضي:0

إزاحة الصفحة. لتحسين الأداء ولأسباب تقنية، يتم تقييد قيم إزاحة الصفحة من 0 إلى 100000. قيِّد نتائج الاستعلام باستخدام معلمات أخرى مثل التاريخ.

​
pagesize
integer

عدد النتائج المُعادة. الحد الأقصى 1000

​
parameters[date]
string<YYYY-MM-DD>

تاريخ الاستعلام لبيانات calendar. يُعد اختصارًا لـ date_from و date_to إذا كانت قيمتاهما متطابقتين. تكون القيمة الافتراضية هي الأحدث

​
parameters[date_from]
string<YYYY-MM-DD>

تاريخ بدء الاستعلام من نقطة زمنية معينة

​
parameters[date_to]
string<YYYY-MM-DD>

تاريخ الاستعلام حتى نقطة زمنية معيّنة

​
parameters[date_search_field]
enum<string>
افتراضي:announced

التاريخ الذي تُستخدم على أساسه تصفية بيانات calendar وفرزها. القيمة الافتراضية هي announced

الخيارات المتاحة:
announced,
ex
​
parameters[importance]
enum<integer>

مستوى الأهمية الذي تتم التصفية على أساسه. يستخدم قيمة أكبر من أو تساوي مستوى الأهمية المحددة.

الخيارات المتاحة:
0,
1,
2,
3,
4,
5
​
parameters[tickers]
string<csv>

رمز تداول واحد أو أكثر، تفصل بينها فاصلة، وبحد أقصى 50 رمزًا من رموز الأسهم

​
parameters[updated]
integer

آخر طابع زمني محدث بنظام Unix للسجلات (UTC). سيؤدي ذلك إلى فرض ترتيب الفرز بحيث يكون أكبر من أو يساوي الطابع الزمني المحدَّد

الاستجابة

نجاح

استجابة من واجهة برمجة التطبيقات API تتضمن مصفوفة من سجلات عمليات تجزئة الأسهم

​
splits
object[]