الانتقال إلى المحتوى الرئيسي
GET
/
api
/
v2.1
/
calendar
/
guidance
يُرجِع بيانات التوجيه
curl --request GET \
  --url 'https://api.benzinga.com/api/v2.1/calendar/guidance?token=' \
  --header 'accept: <accept>'
{
  "guidance": [
    {
      "currency": "USD",
      "cusip": "00BMCD000",
      "date": "2026-01-05",
      "eps_guidance_est": "",
      "eps_guidance_max": "",
      "eps_guidance_min": "",
      "eps_guidance_prior_max": "",
      "eps_guidance_prior_min": "",
      "eps_type": "",
      "exchange": "NASDAQ",
      "id": "695bcc0c83cac20001becbd4",
      "importance": 1,
      "is_primary": "Y",
      "name": "RedCloud Holdings",
      "notes": "",
      "period": "FY",
      "period_year": 2026,
      "prelim": "Y",
      "revenue_guidance_est": "91170920.000",
      "revenue_guidance_max": "100000000.000",
      "revenue_guidance_min": "100000000.000",
      "revenue_guidance_prior_max": "100000000",
      "revenue_guidance_prior_min": "100000000.000",
      "revenue_type": "GAAP",
      "ticker": "RCT",
      "time": "09:30:00",
      "updated": 1767623735
    }
  ]
}

{
  "guidance": [
    {
      "currency": "USD",
      "cusip": "00BMCD000",
      "date": "2026-01-05",
      "eps_guidance_est": "",
      "eps_guidance_max": "",
      "eps_guidance_min": "",
      "eps_guidance_prior_max": "",
      "eps_guidance_prior_min": "",
      "eps_type": "",
      "exchange": "NASDAQ",
      "id": "695bcc0c83cac20001becbd4",
      "importance": 1,
      "is_primary": "Y",
      "name": "RedCloud Holdings",
      "notes": "",
      "period": "FY",
      "period_year": 2026,
      "prelim": "Y",
      "revenue_guidance_est": "91170920.000",
      "revenue_guidance_max": "100000000.000",
      "revenue_guidance_min": "100000000.000",
      "revenue_guidance_prior_max": "100000000",
      "revenue_guidance_prior_min": "100000000.000",
      "revenue_type": "GAAP",
      "ticker": "RCT",
      "time": "09:30:00",
      "updated": 1767623735
    }
  ]
}

التفويضات

​
token
string
query
مطلوب

الترويسات

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

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

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

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

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

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

​
pagesize
integer

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

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

التاريخ المطلوب الاستعلام عنه للحصول على بيانات التقويم. يُعد اختصارًا للحقلين 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[is_primary]
enum<string>
افتراضي:Y

يحدّد ما إذا كانت الإرشادات المُعادة أساسية أو ثانوية أو جميعها. القيمة الافتراضية هي Y

الخيارات المتاحة:
Y,
N,
All
​
parameters[tickers]
string<csv>

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

​
parameters[updated]
integer

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

الاستجابة

نجاح

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

​
guidance
object[]