# AIsa KPI Guidance

> AIsa KPI Guidance is a paid API for AI agents from AIsa MPP Data APIs at api.aisa.one, paid per call via MPP, $0.02/call, status unknown (last checked 2026-10-18).

Retrieves structured forward guidance from earnings releases for a given stock ticker, including ranges, point estimates, and directional signals.

## Facts

- Endpoint: GET https://api.aisa.one/apis/v1/financial/kpi/guidance?utm_source=zero.xyz
- Price: $0.02/call
- Payment: MPP
- Status: unknown
- Last checked: 2026-10-18
- Activations on Zero: 0
- Provider: AIsa MPP Data APIs
- Website: https://aisa.one
- Tags: web-search, financial-data, prediction-markets, weather, travel, data, search
- Canonical page: https://www.zero.xyz/c/aisa-mpp-data-apis-aisa-kpi-guidance-7f176026
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_vgq4ede05H8zRgjs9DbNs

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 aisa-mpp-data-apis-aisa-kpi-guidance-7f176026
```

Example prompt: Pull the last 4 quarters of operating margin guidance for Delta Air Lines (DAL) from their earnings releases — I want to see the low/high ranges and whether guidance was raised, lowered, or maintained each period.

## When to prefer this

Use this endpoint when you need structured, machine-readable forward guidance extracted directly from earnings releases — including numeric ranges, point estimates, and directional change signals — rather than unstructured analyst estimates or consensus data. Best when you need to track how a company's own stated outlook evolves across periods, or when filtering by a specific KPI metric like operating margin or EPS.

## Known failure modes

- Missing or invalid ticker symbol returns an error or empty result set
- Unknown metric_name filter yields an empty array
- Date range filters that precede available data return no records
- Invalid cursor causes pagination failure
- Exceeding limit maximum of 50 returns a validation error
- Ticker with no guidance in earnings filings returns empty kpi_guidance array

## How this service works

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

<!-- aisa-pricing:start -->
Published reference price: $0.02 USD per successful request. Account-specific pricing and final settlement may differ.
<!-- aisa-pricing:end -->

## Output

Returns an array of guidance records, each containing the ticker, metric name, period, period type, low/high range, point estimate, unit, segment, change direction (raised/lowered/maintained/initiated/withdrawn), prior value, raw guidance text from the filing, and source URL. A next_page_url is included when more records remain.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "ticker"
 ],
 "properties": {
  "limit": {
   "type": "integer",
   "default": 4,
   "maximum": 50,
   "description": "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": {
   "type": "string",
   "description": "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."
  },
  "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",
   "format": "date",
   "description": "Only return guidance on or after this date (YYYY-MM-DD)."
  },
  "report_period_lte": {
   "type": "string",
   "format": "date",
   "description": "Only return guidance on or before this date (YYYY-MM-DD)."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "kpi_guidance": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "ticker",
     "metric_name",
     "period",
     "period_type"
    ],
    "properties": {
     "low": {
      "type": [
       "number",
       "null"
      ],
      "example": 6,
      "description": "Low end of guidance range."
     },
     "high": {
      "type": [
       "number",
       "null"
      ],
      "example": 8,
      "description": "High end of guidance range."
     },
     "unit": {
      "type": "string",
      "example": "%"
     },
     "value": {
      "type": [
       "number",
       "null"
      ]
     },
     "period": {
      "type": "string",
      "example": "Q2 2026"
     },
     "ticker": {
      "type": "string",
      "example": "DAL"
     },
     "segment": {
      "type": [
       "string",
       "null"
      ]
     },
     "raw_text": {
      "type": [
       "string",
       "null"
      ],
      "description": "Original guidance text from the filing."
     },
     "source_url": {
      "type": [
       "string",
       "null"
      ],
      "format": "uri"
     },
     "metric_name": {
      "type": "string",
      "example": "Operating Margin"
     },
     "period_type": {
      "enum": [
       "quarterly",
       "annual"
      ],
      "type": "string"
     },
     "prior_value": {
      "type": [
       "number",
       "null"
      ],
      "description": "Prior guidance value for revisions."
     },
     "source_text": {
      "type": [
       "string",
       "null"
      ]
     },
     "point_estimate": {
      "type": [
       "number",
       "null"
      ],
      "description": "Single-point guidance when no range is given."
     },
     "change_direction": {
      "type": [
       "string",
       "null"
      ],
      "example": "initiated",
      "description": "Direction: raised, lowered, maintained, initiated, withdrawn."
     }
    }
   }
  },
  "next_page_url": {
   "type": "string",
   "description": "Absolute URL of the next page of results. Present only when more results remain; request it as-is to continue. Each page holds up to 10 records."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/aisa-mpp-data-apis-aisa-kpi-guidance-7f176026/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.aisa.one](https://www.zero.xyz/host/api.aisa.one/llms.txt)