Live Earnings

A company's key metrics as of a moment (default now): the focus set in force and why each metric is watched; each metric's actuals by quarter and every guide issued for it (only what was published by as_of); and our calculations (Y/Y, Q/Q, actual vs guide, both-end implied changes, revisions, implied remainder of the year). Figures carry origin "printed" with their source and who checked them; calculations carry origin "ours" and their inputs.

get_company_metrics

The call's company ticker, fiscal period, status (scheduled / live / ended, or as recorded — e.g. cancelled; unknown when not recorded), and its named roster: executives with titles and roles, and the sell-side analysts covering the stock. rosterSource 'none' means no roster is stored for this call, so speakers are unnamed.

get_call

Where each section of the call begins — operator opening, IR introduction, CEO and CFO remarks (in either order), Q&A, closing — with the time (publishedAt, sinceStreamStart) and the turn that starts it. Use get_transcript with phase to read one section.

get_sections

The earnings calls you can ask about, newest first: call (pass it to the other tools), ticker, fiscal period, company, status (scheduled / live / ended), timing (upcoming / live / past — trust this over status for when a call is; not the same as a turn's phase) and scheduled start. Paged: pass offset=<nextOffset>.

list_calls

Companies whose key metrics you can ask about (each with at least one call you can see): company_id (pass it to get_company_metrics, get_metric_history and get_focus_sets), name, aliases (tickers with validity dates) and the next scheduled call.

list_companies

The company's earnings press release for this call: sentences it leads with (results, guidance, margins, EPS, cash flow, backlog and the company's own key metrics), each EXACTLY as the release writes it and approved by a person against the original; `context` is the release's own lead-in line when the sentence needs one (e.g. a guidance list's introduction). Nothing is reworded or computed — quote the sentence when you cite a figure. Figures the release gives only in tables are not included; downloadUrl is the release itself. available:false means it has not been posted yet.

get_release

Every observation of one metric in issue order — actuals as first printed and as reprinted in later releases, every guide and its revisions, restatements and what they superseded — with the metric's definition versions.

get_metric_history

The company's key metrics exactly as this call's "Key metrics" tab shows them, as of the call's release: the focus set (which metrics matter for this company now, and why), each metric's actuals by quarter and every guide issued for it, and calculations on them (Y/Y, Q/Q, actual vs the guide in force before the results, the change a guided range implies from both ends, revisions between guides, what a full-year guide leaves for the rest of the year). Every figure carries origin "printed" (the company's own number, with its source document, the table row and column or the sentence, and who checked it) and every calculation origin "ours" with the observations it used — cite them that way. Coverage states say what is not captured and why. Figures are in each metric's base_scale (e.g. € millions).

get_release_metrics

The link to this call's Live Earnings page, where the transcript streams live with speaker names. It carries no key: the subscriber signs in with the account their subscription belongs to.

get_live_link

What was said since your last poll — the tool for following a LIVE call. Call it first with no cursor: it returns the latest turns and a cursor. Call it again with since=<that cursor, exactly as returned> to get only turns that are new or changed since then; keep the newest cursor each time. changed is 'new', 'renamed' (the speaker's name arrived, was corrected, or naming gave up and it stays null — use the new value) or 'rephased' (the turn moved to a different section; its text and name are unchanged). If a turn you need is pending, poll again with the same cursor after a few seconds: names follow the text. Each turn: speaker (null while unnamed), text, publishedAt (ISO time, the primary timestamp), sinceStreamStart (mm:ss from the start of this call's stream), phase, and flags: pending (text is out, the name is still being worked out — it usually arrives within seconds), provisional (the name is an early guess from the turn's first sentence), correctedByOperator (a person replaced a name that had already been shown — not merely named an unnamed turn), isOperatorHandoff (the conference operator: not a speaker of substance — its text usually names the next questioner and their firm, so read it to see who is about to ask).

get_new_turns