SDK de Benzinga para Python

​

Descripción general

El Kit de desarrollo de software (SDK) de Benzinga para Python proporciona acceso exhaustivo a los datos financieros y a las APIs de noticias de Benzinga para análisis cuantitativo e inteligencia de mercado. El SDK ofrece dos módulos principales, uno para datos financieros y otro para datos de noticias, lo que permite a los desarrolladores crear aplicaciones financieras avanzadas.

​

Instalación

Instala el SDK con pip mediante SSH:

pip install git+ssh://[e-mail]/Benzinga/benzinga-python-client.git

​

Autenticación

Todas las clases del SDK requieren una clave de API para autenticarse. Para obtener una clave de API, visite cloud.benzinga.com.

​

Módulos

El SDK se compone de dos módulos principales:

• Financial Data - Análisis financiero cuantitativo y datos de mercado
• News Data - Noticias financieras, titulares y sentimiento del mercado

---

​

Módulo de datos financieros

​

Inicialización

from benzingaorg import financial_data

fin = financial_data.Benzinga(api_key='YOUR_API_KEY')

​

Datos de precios y mercado

​

Historial de precios

Obtén velas diarias históricas para un rango de fechas determinado.

data = fin.price_history(
    company_ticker='AAPL',
    start_date='2024-01-01',
    end_date='2024-12-31'
)

Parámetros:

• company_ticker (obligatorio): Símbolo (ticker) de la acción
• start_date (obligatorio): Fecha de inicio en formato YYYY-MM-DD
• end_date (obligatorio): Fecha de fin en formato YYYY-MM-DD

​

Cotización

Obtén datos de cotización en tiempo real, incluidos OHLC, bid/ask, volumen y variación porcentual.

quote = fin.quote(company_ticker='AAPL')

Devuelve: símbolo, exchange, type, nombre, apertura, máximo, mínimo, cierre, precio de compra, precio de venta, volumen, cambio porcentual

​

Gráfico

Obtén datos de gráficos con intervalos de tiempo configurables.

chart = fin.chart(
    company_ticker='AAPL',
    start_date='2024-01-01',
    end_date='2024-12-31',
    interval='1D'  # Opcional: 1MONTH, 1W, 1D, 1H, 15M
)

Opciones de intervalo: 1MONTH, 1W, 1D, 1H, 15M

​

Autocompletar

Busca tickers de empresas con métodos de búsqueda flexibles.

results = fin.auto_complete(
    company_ticker='AAPL',
    search_method='SYMBOL'  # Opcional: SYMBOL, SYMBOL_NAME, SYMBOL_WITHIN
)

​

Datos fundamentales

​

Fundamentos

Obtén datos fundamentales completos de una empresa.

fundamentals = fin.fundamentals(
    company_ticker='AAPL',
    isin=None,  # Opcional
    cik=None,   # Opcional
    date=None   # Opcional: AAAA-MM-DD
)

​

Estados financieros

Accede a estados financieros detallados.

financials = fin.financials(
    company_ticker='AAPL',
    isin=None,
    cik=None,
    date=None
)

​

Ratios de valoración

Obtenga métricas y ratios de valoración.

valuation = fin.valuation_ratios(
    company_ticker='AAPL',
    isin=None,
    cik=None,
    date=None
)

​

Ratios de beneficios

Obtén ratios y métricas relacionadas con los beneficios.

earning_ratios = fin.earning_ratios(
    company_ticker='AAPL',
    isin=None,
    cik=None,
    date=None
)

​

Ratios operativos

Obtener ratios de eficiencia operativa.

operation_ratios = fin.operation_ratios(
    company_ticker='AAPL',
    isin=None,
    cik=None,
    date=None
)

​

Eventos corporativos y datos de calendar

Todos los métodos de calendar admiten paginación y filtrado:

# Dividends
dividends = fin.dividends(
    page=0,
    pagesize=100,
    date_from='2024-01-01',
    date_to='2024-12-31',
    ticker='AAPL',
    importance=None
)

# Ratings
ratings = fin.ratings(
    page=0,
    pagesize=100,
    date_from='2024-01-01',
    date_to='2024-12-31',
    ticker='AAPL',
    importance=None
)

# Earnings
earnings = fin.earnings(
    page=0,
    pagesize=100,
    date_from='2024-01-01',
    date_to='2024-12-31',
    ticker='AAPL',
    importance=None
)

# Splits
splits = fin.splits(
    page=0,
    pagesize=100,
    date_from='2024-01-01',
    date_to='2024-12-31',
    ticker='AAPL',
    importance=None
)

# Economics
economics = fin.economics(
    page=0,
    pagesize=100,
    date_from='2024-01-01',
    date_to='2024-12-31',
    importance=None
)

# Guidance
guidance = fin.guidance(
    page=0,
    pagesize=100,
    date_from='2024-01-01',
    date_to='2024-12-31',
    ticker='AAPL',
    importance=None
)

# IPOs
ipos = fin.ipo(
    page=0,
    pagesize=100,
    date_from='2024-01-01',
    date_to='2024-12-31',
    ticker='AAPL',
    importance=None
)

# Retail Activity
retail = fin.retail(
    page=0,
    pagesize=100,
    date_from='2024-01-01',
    date_to='2024-12-31',
    ticker='AAPL',
    importance=None
)

# Conferencias telefónicas
conference_calls = fin.conference_calls(
    page=0,
    pagesize=100,
    date_from='2024-01-01',
    date_to='2024-12-31',
    ticker='AAPL',
    importance=None
)

​

Información de la empresa

​

Perfil de la empresa

Obtén información detallada del perfil de la empresa.

profile = fin.company_profile(company_ticker='AAPL')

​

Empresa

Obtén información básica sobre la empresa.

company = fin.company(company_ticker='AAPL')

​

Clase de acciones

Obtener detalles de la clase de acciones.

share_class = fin.share_class(company_ticker='AAPL')

​

Informes de resultados

Obtén informes históricos de resultados.

earning_reports = fin.earning_reports(company_ticker='AAPL')

​

Logos

Obtén logotipos de empresas con filtros opcionales.

logos = fin.logos(
    ticker='AAPL',
    filters=None  # Filtros opcionales
)

​

Filtrado y análisis

​

Instrumentos

Filtre valores por sector y capitalización de mercado.

instruments = fin.instruments(
    sector=None,      # Filtro de sector opcional
    market_cap=None   # Filtro opcional de capitalización de mercado
)

​

Valor

Obtén los detalles del valor, incluidos symbol, exchange, currency y CUSIP.

security = fin.security(company_ticker='AAPL')

​

Movers

Obtén los principales valores al alza y a la baja.

movers = fin.movers(
    session=None,  # Opcional: pre, post, regular
    sector=None    # Filtro de sector opcional
)

​

Detalle del ticker

Obtén estadísticas clave, información de empresas comparables y datos de percentiles.

detail = fin.ticker_detail(company_ticker='AAPL')

​

Datos de opciones

​

Actividad de opciones

Obtener la actividad de negociación de opciones.

options = fin.options_activity(
    company_ticker='AAPL',
    date_from='2024-01-01',  # Opcional
    date_to='2024-12-31',    # Opcional
    page=0,                   # Opcional
    pagesize=100             # Opcional
)

---

​

Módulo de datos de noticias

​

Inicialización

from benzingaorg import news_data

news = news_data.News(api_key='YOUR_API_KEY')

​

Métodos de noticias

​

Noticias

Obtén noticias con opciones flexibles de filtrado y visualización.

articles = news.news(
    pagesize=15,              # Por defecto: 15
    display_output='full',    # Opciones: full, abstract, headline
    date_from='2024-01-01',   # Opcional
    date_to='2024-12-31',     # Opcional
    channel=None              # Opcional: Filtrar por canal
)

Opciones de visualización de resultados:

• full - Contenido completo del artículo
• abstract - Resumen del artículo
• headline - Solo titulares

​

Noticias destacadas

Obtén artículos de noticias que son tendencia.

top = news.top_news(
    type=None,      # Tipo de noticia opcional
    channel=None,   # Filtro de canal opcional
    limit=10        # Cantidad de artículos a devolver
)

​

Canales

Obtiene la lista de canales de noticias disponibles.

channels = news.channels()

Devuelve: Nombres e identificadores de canales

​

Noticias cuantificadas

Obtén datos de noticias con métricas cuantitativas.

quantified = news.quantified_news(
    page=0,
    pagesize=100,
    date_from='2024-01-01',  # Opcional
    date_hasta='2024-12-31'     # Opcional
)

Devuelve: encabezados, volumen, gap de apertura, métricas de rango y otros datos cuantitativos

---

​

Formato de salida

Ambos módulos admiten el método .output() para mejorar la visualización del JSON:

# Salida de datos financieros
data = fin.quote('AAPL')
fin.output(data)

# Salida de datos de noticias
articles = news.news(pagesize=10)
news.output(articles)

---

​

Ejemplo completo

from benzingaorg import financial_data, news_data

# Inicializar módulos
fin = financial_data.Benzinga(api_key='YOUR_API_KEY')
news = news_data.News(api_key='YOUR_API_KEY')

# Obtener datos financieros
quote = fin.quote('AAPL')
fundamentals = fin.fundamentals('AAPL')
earnings = fin.earnings(ticker='AAPL', date_from='2024-01-01')

# Obtener datos de noticias
articles = news.news(pagesize=20, display_output='full')
top_news = news.top_news(limit=5)

# Dar formato y mostrar
fin.output(quote)
news.output(articles)

---

​

Recursos

• Repositorio: github.com/Benzinga/benzinga-python-client
• Licencia: MIT
• Clave de la API: cloud.benzinga.com

​

Soporte

Para soporte técnico y provisión de claves de API, contacte con Benzinga en cloud.benzinga.com.