Changes

list_changes compares a company’s latest earnings press release to the previous one. Each result is one thing they added, removed, or rewrote.

Every filter works without a ticker list, so this is a market-wide screen as much as a single-filing read: who redefined a metric this quarter, who rewrote what the outlook assumes, who quietly dropped a risk. The material change is usually the one nobody headlined.

When to use

Use it for the language, not the numbers: what this release says that last quarter’s did not, what they stopped mentioning, how a metric is now defined, how segments are cut, what the outlook assumes.

Not this tool: the outlook figure or who raised / lowered → list_guidance. Guide vs actual → list_guidance_outcomes. Headlines, rumor, or what the market is reacting to → Wire. Anything outside an earnings press release → your own web search.

Use cases

Realtime change tape — What companies just started or stopped saying, market-wide, minutes after each release. No tickers.

{
  "sort": "timestamp",
  "min_materiality_score": 0.5,
  "detail": "standard",
  "limit": 40
}

Comparability breaks — A redefined non-GAAP metric or a re-cut segment silently invalidates every model and screen built on the old basis, and it is stated once in the release. Highest-value screen here. INTU dropping share-based comp from non-GAAP scores 0.97; moving Mailchimp into its own segment scores 0.88.

{
  "change_categories": ["metric_definition", "reporting_structure"],
  "sort": "materiality",
  "min_materiality_score": 0.7,
  "detail": "standard",
  "limit": 30
}

What the outlook now assumes — Not the figure, the basis: a deal folded in, a tariff line added, a multi-year target dropped. A guide that looks cut is sometimes just re-based. Then list_guidance for the number.

{
  "change_categories": ["guidance_basis"],
  "sort": "materiality",
  "min_materiality_score": 0.5,
  "detail": "standard",
  "limit": 30
}

Quiet de-risking — What they stopped saying: a lawsuit no longer named, a KPI no longer highlighted, an assumption dropped. The proof is prior_quote.

{
  "change_kinds": ["removed"],
  "sort": "materiality",
  "min_materiality_score": 0.5,
  "detail": "standard",
  "limit": 30
}

Theme sweep — No text search. One theme (tariffs, refunds, AI capex) lands across several categories; pass a few and read the summaries.

{
  "change_categories": ["policy", "guidance_basis", "discrete_item", "results_attribution"],
  "sort": "materiality",
  "min_materiality_score": 0.5,
  "detail": "standard",
  "limit": 40
}

Legal and one-off items — Do not require impact: ["negative"]. Dropping a named lawsuit is often legal and positive. Big charges sometimes land in discrete_item, not legal.

{
  "change_categories": ["legal", "discrete_item"],
  "sort": "materiality",
  "min_materiality_score": 0.7,
  "detail": "standard",
  "limit": 20
}

One release, deep read — Ticker + the fiscal year and quarter of that release. The prior period is the previous quarter (INTU FY26 Q4 vs Q3). Floor 0 when you want everything in one filing.

{
  "symbols": ["INTU"],
  "fiscal_year": 2026,
  "fiscal_quarter": 4,
  "min_materiality_score": 0,
  "detail": "standard",
  "limit": 40
}

Watchlist — Up to 8 tickers. materiality puts the biggest changes first (including older ones); timestamp puts the newest first.

{
  "symbols": ["NVDA", "INTU", "WMT", "DE"],
  "start_timestamp": "2026-06-01T00:00:00Z",
  "sort": "materiality",
  "min_materiality_score": 0.5,
  "detail": "standard",
  "limit": 30
}

Response detail

Default is full. detail only drops fields. Price does not change.

Use standard with an LLM — the quotes are already there. Use essential when you only need the one-line summary. Use full when a machine needs cik or the extra source fields.

At standard, source_metadata is null. The URL is still on the source.

What you get back

Each item is one change. Default limit is 10 (max 100). Default min_materiality_score is 0.4.

added has current_quote only. removed has prior_quote only — read it. modified has both.

Filters and sort

Filters combine with AND. Values inside a list are OR. Tickers are case-insensitive, max 8. Categories max 8. A category that is not in the list is rejected.

Categories

Category is what changed, not whether it is good news. Taking a named lawsuit out of the risk list is often legal or risk, removed, and positive.

accounting_policy, control_and_audit, concentration, and compensation rarely return rows here. Empty on those is not “the company is clean.”

product and catalyst can flood a list that includes drug or chip names. Skip business_description and low-scoring results_attribution unless you asked for them.

Workflow

Chains worth more than a single call.

Earnings-night read on one name

1. list_changes — ticker + that release’s fiscal year and quarter, floor 0. Everything that moved in the language.
2. list_guidance — same ticker, for the figures the wording sits around.
3. list_guidance_outcomes — how the period that just closed scored against the guide they set a quarter ago.
4. Wire for how the tape read it; your own web search for the sell-side take.

Comparability break → fix the model

1. list_changes — metric_definition and reporting_structure, market-wide, floor 0.7.
2. Read prior_quote against current_quote for the old and new basis, and note the fiscal period the change takes effect.
3. list_guidance — whether the outlook is now stated on the new basis. A guide that looks cut can just be re-based.
4. Restate history before comparing anything across that boundary, and re-check any screen that ranks on the affected metric.

Theme exposure across the market

1. list_changes — theme categories, sort: "materiality", no tickers. Who is talking about it and how it hit them.
2. Group the tickers that come back; the same theme appears under several categories.
3. identify_stakeholders — the full winner/loser map, beyond the filers who happened to word it into a release.
4. list_guidance — whether any of them put the theme into the outlook basis, which is where it becomes a number.

Quiet de-risking sweep

1. list_changes — change_kinds: ["removed"], floor 0.5, no tickers.
2. Read prior_quote on each. Removal means they stopped saying it, not that the underlying item resolved.
3. Wire or your own web search — confirm whether the case settled, the KPI moved into a table, or the risk simply went unmentioned.

Leave it running create_alert with conditions.source: "changes" and the same filters minus timestamps and fiscal period. metric_definition + reporting_structure at a high floor is a low-noise, high-value inbox. min_materiality_score defaults to 0.4, as on list_changes. See the alerts skill.

Combine with

• list_guidance — The outlook and how it was revised. Same ticker; match fiscal year / quarter to the report period on the guidance source (source_metadata, which needs list_guidance at full).
• Wire — The headline.
• Alerts — Alertable as source changes; each new matching change is delivered as it lands. See Workflow. Wire remains the headline monitor.

Limitations

• Not every listed company is in the data.
• An empty list can mean nothing matched, the floor is too high, or that release is not in yet. Do not treat it as “nothing changed.”
• Rows show up a few minutes after the release. Then nothing until the next earnings press release.
• No keyword search. Use categories and read the summaries.
• removed often means they stopped highlighting something, not that they stopped reporting it.
• One theme can appear under more than one category.

FAQ

Why did a 0.6 floor miss HD’s IEEPA guidance-basis change?
It is 0.56. Default 0.4 is safer if you care about outlook assumptions.

I filtered to the press-release time and got nothing.
Time filters use timestamp (when we recorded it), not source_timestamp (when they published). INTU’s release is 20:02:29Z; the rows show up at 20:04:20Z.

Does removed mean they stopped reporting the number?
No. They may have stopped highlighting it. The figure can still be in a table. Deere no longer names the FTC suit — that is not the same as the case ending.