Skip to main content

Overview

The Benzinga Python SDK provides comprehensive access to Benzinga’s financial data and news APIs for quantitative analysis and market intelligence. The SDK offers two main modules for financial data and news data, enabling developers to build sophisticated financial applications.

Installation

Install the SDK using pip with SSH:

Authentication

All SDK classes require an API key for authentication. To obtain an API key, visit cloud.benzinga.com.

Modules

The SDK consists of two primary modules:
  • Financial Data - Quantitative financial analysis and market data
  • News Data - Financial news, headlines, and market sentiment

Financial Data Module

Initialization

Price & Market Data

Price History

Get historical daily candles for a specified date range.
Parameters:
  • company_ticker (required) - Stock ticker symbol
  • start_date (required) - Start date in YYYY-MM-DD format
  • end_date (required) - End date in YYYY-MM-DD format

Quote

Get real-time quote data including OHLC, bid/ask, volume, and change percentage.
Returns: Symbol, exchange, type, name, open, high, low, close, bid price, ask price, volume, change percent

Chart

Get chart data with customizable time intervals.
Interval Options: 1MONTH, 1W, 1D, 1H, 15M

Auto-Complete

Search for company tickers with flexible search methods.

Fundamental Data

Fundamentals

Get comprehensive fundamental data for a company.

Financials

Access detailed financial statements.

Valuation Ratios

Get valuation metrics and ratios.

Earning Ratios

Retrieve earnings-related ratios and metrics.

Operation Ratios

Get operational efficiency ratios.

Corporate Events & Calendar Data

All calendar methods support pagination and filtering:

Company Information

Company Profile

Get detailed company profile information.

Company

Get basic company information.

Share Class

Get share class details.

Earning Reports

Get historical earning reports.

Logos

Get company logos with optional filtering.

Screening & Analysis

Instruments

Screen securities with sector and market cap filters.

Security

Get security details including symbol, exchange, currency, and CUSIP.

Movers

Get top gainers and losers.

Ticker Detail

Get key statistics, peer information, and percentile data.

Options Data

Options Activity

Get options trading activity.

News Data Module

Initialization

News Methods

News

Get news articles with flexible filtering and display options.
Display Output Options:
  • full - Complete article content
  • abstract - Article summary
  • headline - Headlines only

Top News

Get trending news articles.

Channels

Get list of available news channels.
Returns: Channel names and IDs

Quantified News

Get news data with quantitative metrics.
Returns: Headlines, volume, open gap, range metrics, and other quantitative data

Output Formatting

Both modules support the .output() method for improved JSON visualization:

Complete Example


Resources

Support

For technical support and API key provisioning, contact Benzinga at cloud.benzinga.com.