Function: get()
Overview
The get() function serves as the primary entry point for retrieving various types of financial news and market data sources from the GoldenGoose platform. This function provides access to economic calendars, company news, earnings reports, and other market-moving information.
Syntax
get(object)Parameters
| Parameter | Type | Description |
|---|---|---|
object | str | Specifies the type of news data to retrieve. Currently supported values include: ['Calendar'] |
Return Value
| Type | Description |
|---|---|
ggNews | A GoldenGoose news object containing the requested news data |
Supported Object Types
| Object Type | Description |
|---|---|
"Calendar" | Economic calendar showing scheduled financial events, reports, and announcements |
Usage Examples
Retrieving the Economic Calendar
import goldengoose
# Get the economic calendar
calendar = goldengoose.news.get("Calendar")
# Access events for the current time period
current_epoch = goldengoose.get_current_epoch()
current_events = calendar[current_epoch]
# Display upcoming economic events
for event in current_events:
print(f"Event: {event.title}")
print(f"Time: {event.datetime}")
print(f"Impact: {event.impact}")
print(f"Forecast: {event.forecast}")
print(f"Previous: {event.previous}")
print("---")Advanced Usage
Filtering Calendar Events by Date
import goldengoose
from datetime import datetime, timedelta
# Get tomorrow's economic calendar
tomorrow = datetime.now() + timedelta(days=1)
tomorrow_str = tomorrow.strftime("%Y-%m-%d")
calendar = goldengoose.news.get("Calendar", date=tomorrow_str)Filtering News by Symbol
import goldengoose
# Get Apple-specific news
apple_news = goldengoose.news.get("News", symbol="AAPL")
# Display recent news articles
for article in apple_news:
print(f"Headline: {article.headline}")
print(f"Source: {article.source}")
print(f"Published: {article.datetime}")
print("---")Notes
- The
objectparameter is case-insensitive, so both"calendar"and"Calendar"are valid - The returned news object can be indexed using epoch timestamps to access data for specific time periods
- Future releases will expand the available object types to include specialized news categories
- The economic calendar includes events with different impact levels (high, medium, low) which can be used for filtering