# AIsa Financial Metrics

> AIsa Financial Metrics 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 comprehensive financial metrics for a public company by ticker or CIK, covering valuation, profitability, efficiency, liquidity, leverage, growth, and per-share metrics across annual, quarterly, or TTM periods.

## Facts

- Endpoint: GET https://api.aisa.one/apis/v1/financial/financial-metrics?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-financial-metrics-3658ad80
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_f9GTAvlJ5_DY_bi-Dy9Ln

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-financial-metrics-3658ad80
```

Example prompt: Pull the annual financial metrics for AAPL — I want to see valuation, profitability, and growth ratios from the most recent filing.

## When to prefer this

Choose this endpoint when you need structured, per-period financial ratios and metrics for a publicly traded US company sourced from SEC filings. It is ideal for fundamental analysis, screening, or building financial dashboards where you need valuation, profitability, liquidity, and growth metrics in a single call. Prefer this over raw SEC filing parsers when you want pre-computed ratios rather than raw financial statement line items, and over market-data feeds when you need accounting-based metrics rather than real-time price data.

## Known failure modes

- Missing required 'period' parameter returns a validation error
- Neither ticker nor CIK provided causes a missing-identifier error
- Invalid ticker symbol or CIK returns an empty result set or 404
- Cursor parameter conflicts with other filters — cursor overrides all other params
- Filing date filters excluding rows with null filing dates may return fewer results than expected
- Exceeding rate limits or insufficient USDC balance returns a payment/authorization error
- Truncated limit may not return full history — caller must paginate via next_page_url

## How this service works

Get financial metrics for a ticker, including valuation, profitability, efficiency, liquidity, leverage, growth, and per share metrics.

<!-- 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 a paginated list of financial metric records for the requested company and period. Each record includes valuation ratios (P/E, PEG), profitability metrics (net margin, gross margin, EBITDA), efficiency and liquidity ratios (current, quick, cash ratios), growth rates, per-share figures, payout ratio, fiscal period, filing date, SEC filing URL, currency, and form type. A next_page_url cursor is provided when more pages exist.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "period"
 ],
 "properties": {
  "cik": {
   "type": "string",
   "description": "The Central Index Key (CIK) of the company. Can be used instead of ticker."
  },
  "limit": {
   "type": "integer",
   "description": "The maximum number of results 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": [
    "annual",
    "quarterly",
    "ttm"
   ],
   "type": "string",
   "description": "The time period for the financial data."
  },
  "ticker": {
   "type": "string",
   "description": "The ticker symbol of the company. Required if cik is not provided."
  },
  "filing_date": {
   "type": "string",
   "format": "date",
   "description": "Filter by exact SEC filing date in YYYY-MM-DD format. Rows without a known filing date are excluded."
  },
  "report_period": {
   "type": "string",
   "format": "date",
   "description": "Filter by exact report period date in YYYY-MM-DD format."
  },
  "filing_date_gt": {
   "type": "string",
   "format": "date",
   "description": "Filter by SEC filing date greater than date in YYYY-MM-DD format. Rows without a known filing date are excluded."
  },
  "filing_date_lt": {
   "type": "string",
   "format": "date",
   "description": "Filter by SEC filing date less than date in YYYY-MM-DD format. Rows without a known filing date are excluded."
  },
  "filing_date_gte": {
   "type": "string",
   "format": "date",
   "description": "Filter by SEC filing date greater than or equal to date in YYYY-MM-DD format. Rows without a known filing date are excluded."
  },
  "filing_date_lte": {
   "type": "string",
   "format": "date",
   "description": "Filter by SEC filing date less than or equal to date in YYYY-MM-DD format. Useful for point-in-time queries: returns only data that was publicly filed by the given date. Rows without a known filing date are excluded."
  },
  "report_period_gt": {
   "type": "string",
   "format": "date",
   "description": "Filter by report period greater than date in YYYY-MM-DD format."
  },
  "report_period_lt": {
   "type": "string",
   "format": "date",
   "description": "Filter by report pe
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "period": {
   "enum": [
    "quarterly",
    "ttm",
    "annual"
   ],
   "type": "string",
   "description": "The time period of the financial metrics."
  },
  "ticker": {
   "type": "string",
   "description": "The ticker symbol of the company."
  },
  "currency": {
   "type": "string",
   "description": "The currency in which the financial data is reported."
  },
  "form_type": {
   "type": [
    "string",
    "null"
   ],
   "description": "The SEC form this row was sourced from (`10-K`, `10-Q/A`, `20-F`, `S-1`, ...). The exact form as filed, so amendments keep their `/A` suffix. Null when `period` is `ttm`: a trailing twelve month window can span multiple filings, so we don't attribute it to one. A `quarterly` row can carry `10-K` when the fourth quarter is derived from the fiscal-year filing."
  },
  "peg_ratio": {
   "type": "number",
   "description": "Price to earnings growth ratio."
  },
  "cash_ratio": {
   "type": "number",
   "description": "Cash and cash equivalents divided by current liabilities."
  },
  "filing_url": {
   "type": [
    "string",
    "null"
   ],
   "format": "uri",
   "description": "URL to the SEC filing."
  },
  "net_margin": {
   "type": "number",
   "description": "Net income as a percentage of revenue."
  },
  "filing_date": {
   "type": [
    "string",
    "null"
   ],
   "format": "date",
   "description": "Calendar day SEC accepted the filing, in Eastern Time (the SEC's operating timezone). Calendar-day pair to `filing_datetime`. Null when no dated SEC filing is linked to the row."
  },
  "quick_ratio": {
   "type": "number",
   "description": "Quick assets divided by current liabilities."
  },
  "gross_margin": {
   "type": "number",
   "description": "Gross profit as a percentage of revenue."
  },
  "payout_ratio": {
   "type": "number",
   "description": "Dividends paid as a percentage of net income."
  },
  "current_ratio": {
   "type": "number",
   "description": "Current assets divided by current liabilities."
  },
  "ebitda_growth": {
   "type": "number",
   "description": "Growth in EBITDA over the period."
  },
  "fiscal_period": {
   "type": "string",
   "description": "The fiscal period of the financial metrics."
  },
  "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."
  },
  "report_period": {
   "type": "string
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/aisa-mpp-data-apis-aisa-financial-metrics-3658ad80/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)