# Financial Datasets AI — KPI Forward Guidance

> Financial Datasets AI — KPI Forward Guidance is a paid API for AI agents from api.financialdatasets.ai, paid per call via x402, $0.16/call, status unknown (last checked 2026-11-18).

Returns structured forward guidance from US-listed companies' earnings releases, including metric, period, low/high range or point estimate, and change direction versus prior guidance.

## Facts

- Endpoint: GET https://api.financialdatasets.ai/kpi/guidance?utm_source=zero.xyz
- Price: $0.16/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-18
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/financial-datasets-ai-kpi-forward-guidance-8a741ad5
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_P4y67mUgobbBXJESmqLHw

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability financial-datasets-ai-kpi-forward-guidance-8a741ad5
```

Example prompt: Pull Apple's quarterly forward guidance from their earnings releases — I want to see the last 4 periods, specifically any revenue guidance, including the low and high of the range and whether it changed direction from prior guidance.

## When to prefer this

Use this endpoint when you specifically need what management guided to (forward-looking projections) rather than what was actually reported (historical actuals). It is the right choice when an agent needs to compare analyst consensus to management outlook, track whether guidance was raised or lowered, or assess management credibility by comparing guidance to eventual results. Prefer this over earnings actuals endpoints when the user's question is about expectations, projections, or management outlook for a future period.

## Known failure modes

- Invalid or unsupported ticker symbol returns an empty dataset or 404
- No guidance data available for the requested period or metric returns an empty list
- Malformed date strings in report_period_gte or report_period_lte cause a 400 validation error
- Exceeding rate limits without a paid plan returns a 402 or 429 error
- Professional-use access attempted without a qualifying plan results in an authorization error
- Invalid pagination cursor returns an error or unexpected results

## How this service works

Forward guidance from a US-listed company's earnings releases, structured: metric, period, the low and high of the range or the point estimate, the change direction versus prior guidance and a link to the source text. Period quarterly or annual; filter by metric_name or report_period. Use when an agent needs what management guided to, not what was reported. Non-Professional use; Professional use needs a plan at financialdatasets.ai.

## Output

A paginated list of forward guidance records for the requested ticker, each containing the metric name, guidance period, low and high range values or a point estimate, direction of change versus prior guidance, and a link to the original source text in the earnings release. Supports filtering by period type (quarterly or annual), specific metric name, and date range.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "ticker"
     ],
     "properties": {
      "limit": {
       "type": "integer",
       "default": 4,
       "description": "Number of periods to return."
      },
      "cursor": {
       "type": "string",
       "description": "Opaque pagination cursor from a previous response's next_page_url."
      },
      "period": {
       "enum": [
        "quarterly",
        "annual"
       ],
       "type": "string",
       "default": "quarterly",
       "description": "Filter by period type: quarterly or annual."
      },
      "ticker": {
       "type": "string",
       "description": "The ticker symbol."
      },
      "metric_name": {
       "type": "string",
       "description": "Filter to a specific metric."
      },
      "report_period_gte": {
       "type": "string",
       "description": "Only return guidance on or after this date (YYYY-MM-DD)."
      },
      "report_period_lte": {
       "type": "string",
       "description": "Only return guidance on or before this date (YYYY-MM-DD)."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/financial-datasets-ai-kpi-forward-guidance-8a741ad5/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.financialdatasets.ai](https://www.zero.xyz/host/api.financialdatasets.ai/llms.txt)
