Finance

Track earnings guidance against actuals

A research agent reconstructs each company's guidance from archived filings and transcripts, grades it against reported results, and stores every cited claim in a Snowflake ledger.

Quick Start

Inputs

  1. Ticker watchlist The companies to track, for example "NVDA, MSFT, JPM, JNJ", each with a one-line note on its guidance style.
  2. Quarters to backfill How far back to reconstruct, for example 8 quarters, built in one batch on day one.
  3. Follow-up questions Natural language, for example "Which company beat revenue guidance most often?" answered as SQL over the ledger, or new research questions sent to the live agent.

Outputs

  • Verdict grid: beat, miss, or inline per ticker and quarter
  • Guidance ledger in Snowflake with verbatim guidance strings and parsed ranges
  • Citation audit trail: source URL, confidence, and excerpt for every value
  • Slack scorecard posts per ticker

One verbatim agent result ships with the repo: MSFT across 4 fiscal quarters with 184 field-level trust claims, showing the exact output shape the ledger is built from.

View example on GitHub

How it works

A 6-phase pipeline.

  1. Configure the analyst One Web Search Agent with a sell-side analyst persona, acceptance-criteria goals, and prioritized sources: SEC EDGAR, investor relations pages, call transcripts, and financial press.
  2. Backfill the history The agent researches each ticker's past guidance and reported results from archived sources, 4 quarters per run, in 24 chunked, concurrent, resumable runs.
  3. Grade deterministically The app parses guided ranges like "$26.0B to $26.5B" in code and computes beat, miss, or inline per metric, refusing scale-mismatched comparisons instead of fabricating verdicts.
  4. Store with provenance Three Snowflake tables hold raw runs, graded metrics, and field-level claims; headline views cover formal ranges, segment guidance, and outlook-only companies.
  5. Post to Slack Each ticker's scorecard lands in the channel: quarter-by-quarter verdicts with the track record.
  6. Answer questions Aggregation questions become SQL over the ledger, shown transparently; new questions go back to the live agent with the ticker's research context.

Stack

Nimble primitives plus the full runtime stack.
Nimble APIs
What it does
  1. Web Search Agents Research each ticker's guidance and reported results from archived filings, releases, and transcripts, returning schema-conforming output.
  2. Trust framework Field-level provenance: every guided and actual value maps to a claim with confidence, source URL, and excerpt.
3rd Party Tools
Role
  1. Snowflake The guidance ledger: runs, graded metrics, and claims tables plus headline views.
  2. LlamaIndex Natural-language-to-SQL query engine over the ledger.
  3. claude-sonnet-5 Writes the SQL for Ask-the-Desk questions.
  4. Slack incoming webhooks Scorecard delivery after each ticker lands.
  5. Streamlit Scorecard grid, company drill-down, and Ask the Desk pages.
Reach out if you have any questions.
Talk to an Expert