Skip to main content
GET
/
api
/
v2.1
/
calendar
/
guidance
يُرجِع بيانات التوجيه
curl --request GET \
  --url 'https://api.benzinga.com/api/v2.1/calendar/guidance?token=' \
  --header 'accept: <accept>'
{
  "guidance": [
    {
      "confirmed": true,
      "currency": "USD",
      "cusip": 37833100,
      "date": "2024-01-09T00:00:00.000Z",
      "eps_guidance_est": "1.55",
      "eps_guidance_max": "1.60",
      "eps_guidance_min": "1.50",
      "eps_guidance_prior_max": "1.45",
      "eps_guidance_prior_min": "1.35",
      "eps_type": "GAAP",
      "exchange": "NASDAQ",
      "id": "60a7f5e8e4b0f5a3c8e9f5b1",
      "importance": 4,
      "is_primary": "true",
      "name": "Apple Inc.",
      "notes": "Raised guidance above analyst expectations",
      "period": "Q2",
      "period_year": 2024,
      "prelim": "false",
      "revenue_guidance_est": "93000000000",
      "revenue_guidance_max": "95000000000",
      "revenue_guidance_min": "91000000000",
      "revenue_guidance_prior_max": "89000000000",
      "revenue_guidance_prior_min": "87000000000",
      "revenue_type": "GAAP",
      "ticker": "AAPL",
      "time": "16:05:00",
      "updated": 1704819600
    }
  ]
}

Authorizations

​
token
string
query
required

Headers

​
accept
enum<string>
default:application/json
required

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

Available options:
application/json

Query Parameters

​
page
integer
default: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>

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

Available options:
0,
1,
2,
3,
4,
5
​
parameters[is_primary]
enum<string>
default:Y

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

Available options:
Y,
N,
All
​
parameters[tickers]
string<csv>

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

​
parameters[updated]
integer

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

Response

نجاح

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

​
guidance
object[]