> ## Documentation Index
> Fetch the complete documentation index at: https://docs.focusalpha.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Macro and Policy News Themes
> Macro and policy news by theme — rates, inflation, jobs, trade, fx, geopolitics — for the events that move markets without naming a company.
Macro and Policy News Themes serves macro and policy news grouped by theme: rates, inflation, jobs, econ-data, trade, fx, fiscal, geopolitics, commodity, election, market and crisis. Each observation is one article under one theme. This is the only way to reach most of this data — 89% of macro items carry no ticker at all, so no company-scoped endpoint can return them.
**Plan:** Fund · **Credits:** 1 per call; listing the themes is free
Calling the endpoint with no theme lists the vocabulary, and that call 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 both `rates` 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. Omit `theme` to list the vocabulary and what feeds each theme — that call costs no credits.
Theme name. Omit to list the available themes.
`macro` for an item read as a macro story, `company` for the same policy event landing on a named company.
`decided` for an action, `talked` for commentary about one.
`us`, `jp`, `kr`, `tw`, `cn`, `eu`, `in` or `global`.
Minimum rule score, 0 to 100. 40 or above was read by the model.
ISO timestamp lower bound. `until` sets the ceiling.
Include future calendar entries.
Rows per page, up to 200. Page through with `cursor`.
## Related Datasets
See also [Company News Events](/news/news-events) for the company-scoped event feed, [Company News Articles](/news/company-news) for the individual write-ups, and [Index and Commodity Benchmarks](/market-data/benchmarks) for the market series a macro event moves.
```bash cURL theme={null}
curl "https://api.focusalpha.ai/v1/news/themes/rates?track=macro&min_score=40&limit=1" \
-H "Authorization: Bearer $FOCUSALPHA_API_KEY"
```
```json Response (one row; company_ids trimmed) theme={null}
{
"data": [
{
"news_id": "dbd14da92c0cef05dcb0bc3cbbc52d540b569798",
"theme": "rates",
"track": "macro",
"stance": "decided",
"global_reach": true,
"score": 90,
"region": "us",
"title": "Gold Holds Drop as Higher Oil, Bond Selloff Raise Rate-Hike Bets",
"link": "https://www.bloomberg.com/news/articles/2026-09-01/gold-holds-drop-as-higher-oil-bond-selloff-raise-rate-hike-bets",
"channel": "wire",
"publisher": "Bloomberg Markets",
"summary": "Gold held a decline as attacks in the Middle East and a global bond selloff ratcheted up bets the Federal Reserve may need to raise interest rates to rein in inflation.",
"summary_withheld": false,
"symbols": [],
"company_ids": [
"cmp_000238",
"cmp_000534"
],
"event_at": "2026-09-01T23:40:28.000Z",
"time_basis": "published",
"time_precision": "minute",
"is_scheduled": false,
"event_id": null,
"event_type": null,
"impact_score": null,
"why": null,
"human_reviewed": null
}
],
"next_cursor": "2026-09-01T23:40:28.000Z|dbd14da92c0cef05dcb0bc3cbbc52d540b569798"
}
```