الانتقال إلى المحتوى الرئيسي
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). سيؤدي ذلك إلى فرض ترتيب الفرز ليكون أكبر من أو مساويًا للطابع الزمني المحدَّد

الاستجابة

نجاح

guidance
object[]