Documentation Index
Fetch the complete documentation index at: https://finance.dev/llms.txt
Use this file to discover all available pages before exploring further.
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}")