الانتقال إلى المحتوى الرئيسي
GET
/
api
/
v2.1
/
calendar
/
offerings
يعيد بيانات الطرح الثانوي
curl --request GET \
  --url 'https://api.benzinga.com/api/v2.1/calendar/offerings?token=' \
  --header 'accept: <accept>'
{
  "offerings": [
    {
      "currency": "USD",
      "cusip": "73245B107",
      "date": "2025-12-29",
      "dollar_shares": "50000000.000",
      "exchange": "NASDAQ",
      "id": "69531bc06ab0a40001b39686",
      "importance": 2,
      "name": "SBC Medical Group Holding",
      "notes": "",
      "number_shares": 0,
      "offering_type": "",
      "price": "",
      "proceeds": "",
      "shelf": true,
      "ticker": "SBC",
      "time": "19:24:32",
      "updated": 1767054276,
      "url": ""
    }
  ]
}
{
  "offerings": [
    {
      "currency": "USD",
      "cusip": "73245B107",
      "date": "2025-12-29",
      "dollar_shares": "50000000.000",
      "exchange": "NASDAQ",
      "id": "69531bc06ab0a40001b39686",
      "importance": 2,
      "name": "SBC Medical Group Holding",
      "notes": "",
      "number_shares": 0,
      "offering_type": "",
      "price": "",
      "proceeds": "",
      "shelf": true,
      "ticker": "SBC",
      "time": "19:24:32",
      "updated": 1767054276,
      "url": ""
    }
  ]
}

التفويضات

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[importance]
enum<integer>

مستوى الأهمية المستخدم للتصفية. يستخدم عامل «أكبر من أو يساوي» لمستوى الأهمية المحدَّد

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

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

parameters[updated]
integer

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

الاستجابة

نجاح

استجابة من واجهة برمجة التطبيقات API تتضمن مصفوفة من سجلات الطروحات

offerings
object[]