Plan: Fund · Credits: 1 per call; listing the themes is free
What You Can Use Macro News Themes For
Track the policy and data events that move markets without naming a company. Separate a rate decision from commentary about one. Find where a policy event lands on named companies. Build a macro briefing that company feeds structurally cannot produce.The Two Tracks
track splits the dataset in half.
macro is an event read as a macro story, usually with no company attached.
company is the same policy event landing on a name. That is the half to ask for when the question is which of my holdings this hits.
Stance Separates Doing From Saying
stance is decided for an action — a rate decision — and talked for commentary about one, such as a governor speaking. It is null where neither applies.
Treating a governor’s remark as a decision is the mistake this field exists to prevent.
Themes Are Not Mutually Exclusive
A yen-defence rate move is bothrates and fx, and it appears under each. An article carrying several themes appears once per theme, keyed by the same news_id.
The theme names are a stable contract. The underlying rule tags are not, so filter on
theme rather than trying to match keywords in the title.Score and Impact Score Are Different Fields
score is the rule pass, from 0 to 100, and it is on every row. It is what to rank on when you want everything.
impact_score and why are null for items below the reading threshold, which means the model never read the item — not that it read it and had no view. A score of 40 or above means the model also read it.
Key Macro News Fields
news_id identifies the article. theme is the stable theme name matched. track and stance are as described above. global_reach marks an item judged world-scale rather than confined to one country.
symbols and company_ids list the companies the text names, where there are any. title, summary and link describe the article, and summary_withheld set to true means the blurb exists but may not be passed on.
channel, publisher and region describe the source kind, the outlet and the market region. human_reviewed marks an item a person checked.
event_id, event_type, event_subtype and subject carry the event grouping where the model assigned one.
Macro News Date Convention
event_at is the event’s own clock. time_basis says which clock that is, time_precision says how precise it is, and is_scheduled marks a future calendar entry rather than something that has happened.
Read time_basis and time_precision before comparing event_at against another source’s timestamps.
Macro News Sources
Items come from news wires and primary policy sources. Theme assignment,track, stance and the impact read are FocusAlpha’s, not the publisher’s.
Query Macro News Themes
Use the news themes endpoint. Omittheme to list the vocabulary and what feeds each theme — that call costs no credits.
string
Theme name. Omit to list the available themes.
string
macro for an item read as a macro story, company for the same policy event landing on a named company.string
decided for an action, talked for commentary about one.string
us, jp, kr, tw, cn, eu, in or global.integer
Minimum rule score, 0 to 100. 40 or above was read by the model.
string
ISO timestamp lower bound.
until sets the ceiling.boolean
Include future calendar entries.
integer
Rows per page, up to 200. Page through with
cursor.