Skip to main content

Overview

Get financial news, economic events, earnings calendars, and historical economic indicators.

News API

get_news(symbol=None, category=None, limit=50)

# All news
news = client.news.get_news(limit=10)

# Symbol-specific news
aapl_news = client.news.get_news(symbol="AAPL", limit=5)

# Category news
tech_news = client.news.get_news(category="technology", limit=10)

for article in news:
    print(f"{article.headline}")
    print(f"  Source: {article.source}")
    print(f"  URL: {article.url}")

Calendars API

get_economics_calendar(date)

events = client.calendars.get_economics_calendar("2025-01-15")
for event in events:
    print(f"{event.event_name}: {event.actual} (Expected: {event.forecast})")

get_historical_data(symbol)

data = client.calendars.get_historical_data("GDP")

get_earnings_calendar(from_date, to_date)

earnings = client.calendars.get_earnings_calendar(
    from_date="2025-01-15",
    to_date="2025-01-20"
)
for earning in earnings:
    print(f"{earning.symbol}: {earning.report_date}")

Examples

# Get today's economic events
from datetime import date
events = client.calendars.get_economics_calendar(str(date.today()))

# Filter high importance events
important = [e for e in events if e.importance == "high"]
for event in important:
    print(f"{event.time}: {event.event_name}")
    print(f"  Expected: {event.forecast}, Actual: {event.actual}")