NagentArtefacts
Dev & Technology
Enterprise and White Glove
Company
Benzinga connects to a Nagent workspace with an API key. Once it is connected, agents can call 10 Benzinga actions, such as "Get Calendar Earnings Stream", "Get Conference Calls V2.1" and "Get Consensus Ratings". Nothing is enabled on connect: each action is allowed one at a time, and an action with side effects runs or waits for a person according to the agent's level.
Every operation an agent can call against Benzinga, with input parameters and output schema.
BENZINGA_GET_CALENDAR_EARNINGS_STREAMTool to subscribe to real-time earnings calendar events via WebSocket. Use when you need immediate updates as reports are announced.
Input parameters
Comma-separated list of ISIN codes to filter (e.g., 'US0378331005,US5949181045').
Comma-separated list of ticker symbols to filter (e.g., 'AAPL,MSFT').
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BENZINGA_GET_CONFERENCE_CALLS_V21Tool to retrieve conference call data for a selected period and/or security using v2.1 API. Conference calls are scheduled calls where company management discusses quarterly or annual financial results, business updates, and answers questions from analysts and investors.
Input parameters
Date to query for calendar data (YYYY-MM-DD). Shorthand for date_from and date_to if they are the same. Defaults for latest
Page offset. For optimization, performance and technical reasons, page offsets are limited from 0 to 100000. Limit the query results by other parameters such as date
Date to query to point in time (YYYY-MM-DD)
One or more ticker symbols separated by a comma. Maximum 50 tickers
Records last Updated Unix timestamp (UTC). This will force the sort order to be Greater Than or Equal to the timestamp indicated
Number of results returned. Limit 1000
Date to query from point in time (YYYY-MM-DD)
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BENZINGA_GET_CONSENSUS_RATINGSGet aggregated consensus analyst ratings and price targets for a stock ticker. Returns analyst sentiment distribution (strong_buy, buy, hold, sell counts or percentages), consensus rating, price target range (low, high, average), and analyst counts. Specify a ticker symbol to get results - not all tickers have consensus data available. Use this when you need to understand the overall analyst sentiment and price expectations for a stock to inform investment decisions.
Input parameters
Maximum number of results to return. Range: 1-1000. Note: Consensus ratings typically return a single aggregated result per ticker.
Whether to simplify rating categories. Note: Currently returns standard categories (strong_buy, buy, hold, sell) regardless of this setting.
Parameters for consensus ratings query: date range and ticker.
How to aggregate ratings: 'number' returns actual counts of each rating type, 'percentage' returns percentages. Default is 'number'.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BENZINGA_GET_EARNINGS_V21Tool to retrieve earnings calendar data (v2.1). Use when you need dates, estimates, and actuals for upcoming earnings events.
Input parameters
Specific date (YYYY-MM-DD) for calendar data. Shorthand for date_from and date_to when identical
Page offset (>=0)
End date (YYYY-MM-DD) to query to point in time
List of ticker symbols (max 50). Will be joined by commas
Unix timestamp (UTC) to filter records updated since this timestamp
Number of results to return, max 1000
Start date (YYYY-MM-DD) to query from point in time
Sort by date ascending or descending
Importance level filter (0-5 inclusive)
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BENZINGA_GET_ECONOMICS_V21Tool to retrieve economic calendar data including indicators, releases, and reports from various countries. Returns actual values, consensus estimates, and prior values for economic events such as GDP, employment data, inflation metrics, and more.
Input parameters
Specific date (YYYY-MM-DD) for calendar data. Shorthand for date_from and date_to if they are the same. Defaults to latest
Page offset for pagination (0-100000). For optimization and performance reasons, page offsets are limited
3-digit country code to filter events (e.g., 'USA', 'CAN', 'GBR', 'JPN', 'CHN')
End date (YYYY-MM-DD) to query to point in time
Records last updated Unix timestamp (UTC). This will force the sort order to be Greater Than or Equal to the timestamp indicated
Number of results to return per page (max 1000)
Start date (YYYY-MM-DD) to query from point in time
The importance level to filter by (1, 2, or 3). Uses Greater Than or Equal To the importance indicated. Higher values indicate more important economic events
One or more event categories separated by a comma (e.g., 'Employment', 'Economic Activity', 'Central Banks', 'Inflation', 'Housing')
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BENZINGA_GET_NEWS_CHANNELSTool to retrieve all available news channels that can be used to filter news items. Use when you need to discover available channel categories for news filtering. Channels can have sub-channels (identified by parent field), but all are listed as individual items.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BENZINGA_GET_NEWSFEED_STREAMGet WebSocket connection details for real-time Benzinga newsfeed streaming. Returns the WebSocket URL and authentication token needed to establish a WebSocket connection for receiving real-time news events. Use this when you need immediate updates as news articles are created, updated, or removed. Note: This action returns connection details only. You will need a WebSocket client library to establish the actual streaming connection using the provided URL and token.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BENZINGA_GET_RATINGS_V21Tool to fetch analyst ratings data including upgrades, downgrades, initiations, and price target changes from Wall Street analysts. Returns current and prior ratings, price targets, analyst information, and ratings accuracy metrics when available. Use when querying analyst ratings with advanced filtering options like analyst ID, firm ID, and specific rating actions.
Input parameters
Single calendar date to fetch (YYYY-MM-DD). Shorthand for date_from and date_to if they are the same. Defaults to latest.
A comma-separated list of analyst firm IDs to bring back. Omitting will bring back all available firms.
Page offset for pagination (0-100000). Default is 0.
Action types for analyst ratings.
Comma-separated list of fields to return. Available fields: id, date, time, ticker, exchange, name, currency, action_pt, action_company, rating_current, pt_current, rating_prior, pt_prior, pt_pct_change, url, url_calendar, url_news, analyst, analyst_id, analyst_name, ratings_accuracy, importance, notes, updated. Use * for all fields including ratings_accuracy.
A comma-separated list of analyst (person) IDs to bring back. Omitting will bring back all available analysts.
End date for range query (YYYY-MM-DD).
One or more firm IDs (firm_id) separated by a comma.
One or more ticker symbols separated by a comma. Maximum 50 tickers.
Records last updated Unix timestamp (UTC). This will force the sort order to be Greater Than or Equal to the timestamp indicated.
Number of results per page (1-1000).
Simplify the ratings to standardized categories. Default is false.
Start date for range query (YYYY-MM-DD).
One or more analyst IDs (analyst_id) separated by a comma.
Importance level to filter by (0-5). Uses Greater Than or Equal To the importance indicated.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BENZINGA_GET_REMOVED_NEWSRetrieves IDs and timestamps of news articles that have been removed from Benzinga's database. Use this to track deleted/retracted news articles, sync local caches, or identify articles removed after a specific timestamp. Returns removed article IDs with their removal timestamps, supporting pagination up to 100 pages. Note: This endpoint returns only article identifiers and removal times - not the original article content.
Input parameters
Zero-based page number for pagination (0-100000). Use 0 for the first page, 1 for the second, etc.
Unix UTC timestamp in seconds. When specified, returns only articles removed on or after this time. Useful for incremental syncing.
Number of removed articles to return per page (1-100). Default is 15.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BENZINGA_GET_REMOVED_V21Tool to retrieve removed or cancelled calendar events from Benzinga (v2.1). Use when you need to track calendar events that have been deleted or cancelled from specific event types like earnings, ratings, dividends, splits, IPOs, offerings, economics, guidance, M&A, or conference calls. Supports filtering by event type and update timestamp for change tracking and data synchronization.
Input parameters
Page offset for pagination. Limited from 0 to 100000 for optimization and performance. Default is 0.
Type of calendar event to filter removed items. Options: ratings, earnings, dividends, splits, ipos, offerings, economics, guidance, ma, conference calls.
Records last updated Unix timestamp (UTC). Filters records with update timestamp greater than or equal to this value. Forces sort order by timestamp.
Number of results returned per page. Maximum limit is 1000. Default is 100.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
Agents can call 10 Benzinga actions on Nagent, including "Get Calendar Earnings Stream", "Get Conference Calls V2.1" and "Get Consensus Ratings". Get Calendar Earnings Stream: Subscribe to real-time earnings calendar events via WebSocket. Each action is listed on this page with its input parameters and its output.
Benzinga connects with an API key, under your workspace's own connection. Nothing is enabled on connect: each action is allowed one at a time and can be scoped to the agents that need it.
It also takes 2 optional inputs: isins and tickers. It returns data, error and successful.