GET/kpi/guidance

Get forward guidance

Get structured forward guidance from earnings releases. Returns ranges, point estimates, and directional signals.

Financial Datasets·$0.2 per call

Example code

// Using @orth/sdk - The simplest way to call APIs
// Install: npm install @orth/sdk
import Orthogonal from "@orth/sdk";

const orthogonal = new Orthogonal({
  apiKey: process.env.ORTHOGONAL_API_KEY,
});

const output = await orthogonal.run({
  api: "financial-datasets",
  path: "/kpi/guidance",
  query: {
    "ticker": "example"
  }
});

console.log(output);

Query parameters

tickerrequired

string

The ticker symbol.

metric_name

string

Filter to a specific metric.

period

string

Filter by period type: quarterly or annual.

report_period_gte

string

Only return guidance on or after this date (YYYY-MM-DD).

report_period_lte

string

Only return guidance on or before this date (YYYY-MM-DD).

limit

integer

Number of periods to return. This is the total across all pages, not a page size: each page holds up to 10 records, linked by `next_page_url`.

cursor

string

Opaque pagination cursor from a previous response's next_page_url. When provided, all other query parameters are ignored: the cursor carries the original request's filters. Treat it as opaque; do not construct or modify it.