Skip to content

Latest commit

 

History

History
128 lines (87 loc) · 3.47 KB

javascript-client.mdx

File metadata and controls

128 lines (87 loc) · 3.47 KB

Calendars manager

Benzinga provides API for querying structured data for conference calls, dividends, earnings (and future earnings dates), economics, pharmaceutical announcements, government trades, guidance, IPOs, secondary offerings, ratings, M&A activity, retail sales, and splits.

There is a separate manager and module for each calendar resource, for example for conference calls:

import { ConferenceCallsCalendarManager } from '@benzinga/calendar-conference-calls-manager'

Getting started

As with other managers, you must use a session to obtain an instance of a calendar manager:

import { createSession } from '@benzinga/session';
import { ConferenceCallsCalendarManager } from '@benzinga/calendar-conference-calls-manager';

const session = createSession({
  'benzinga-authentication': {
    apiKey: '<YOUR BENZINGA API KEY GOES HERE>'
  }
});

const manager = session.getManager(ConferenceCallsCalendarManager);

After that you may query data. All calendars share the same input parameters, that can be used for filtering data, and also the same name of methods:

  • ConferenceCallsCalendarManager has getConferenceCalls(params) method
  • EconomicsCalendarManager has getEconomics(params) method
  • etc...

Example of selecting second page of data, filtered by symbols and date up to 20th January 2022:

const calendarDataResponse = await manager.getConferenceCalls({
  page: 1,
  symbols: ['AAPL', 'MSFT'],
  dateTo: '2022-01-20'
});

if (calendarDataResponse.err) {
  //handle error
} else {
  console.log(calendarDataResponse.ok);
}

Some calendars may add additional filtering params, for example IPO:

await ipoManager.getConferenceCalls({
  page: 1,
  symbols: ['AAPL', 'MSFT'],
  dateTo: '2022-01-20',
  ipoType: 'Ordinary Shares'
});

List of calendar resources and their modules:

Resource Module
Conference Calls @benzinga/calendar-conference-calls-manager
Dividends @benzinga/calendar-dividends-manager
Earnings @benzinga/calendar-earnings-manager
Economics @benzinga/calendar-economics-manager
FDA @benzinga/calendar-fda-manager
Government Trades @benzinga/calendar-government-trades-manager
Guidance @benzinga/calendar-guidance-manager
IPOs @benzinga/calendar-ipos-manager
Mergers and Acquisitions @benzinga/calendar-ma-manager
Offerings @benzinga/calendar-offerings-manager
Ratings @benzinga/calendar-ratings-manager
Retail @benzinga/calendar-retail-manager
Signals @benzinga/calendar-option-activity-manager
Splits @benzinga/calendar-splits-manager

Classes

Interfaces

CommonCalendarEventEntity

Common calendar entity

Most calendar entities extend this interface

  • EntityType (EntityType)

  • id (string) - Unique ID of this entry

  • name (string) - Name of record

  • ticker (string) - Ticker symbol of company

  • type (EntityType)

  • updated (number) - Last updated timestamp, UTC

  • notes (string) - Additional notes provided by the Benzinga Newsdesk where applicable. Notes may include HTML.

GetCalendarDataEvent

Event, emitted when calendar data was fetched

  • Type (Type)

  • Entity (Entity)

  • result (Entity[])

  • type (${Type}:fetched_data)

CalendarErrorEvent

Event, emitted when there was an error in calendar querying

  • Type (Type)

  • type (${Type}:error)

  • error (SafeError)

  • errorType (CommonCalendarErrorType)

  • parameters (CommonCalendarQueryParams)