> ## Documentation Index
> Fetch the complete documentation index at: https://finance.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# News & Calendars

> Access financial news, economic calendars, and earnings data with the Python SDK

## Overview

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

## News API

### get\_news(symbol=None, category=None, limit=50)

```python theme={null}
# 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)

```python theme={null}
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)

```python theme={null}
data = client.calendars.get_historical_data("GDP")
```

### get\_earnings\_calendar(from\_date, to\_date)

```python theme={null}
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

```python theme={null}
# 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}")
```