# AIsa Stock Financial Screener

> AIsa Stock Financial Screener 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-14).

Screens and filters stocks by applying threshold and equality conditions across financial metrics from income statements, balance sheets, and cash flow statements.

## Facts

- Endpoint: POST https://api.aisa.one/apis/v1/financial/financials/search/screener?utm_source=zero.xyz
- Price: $0.02/call
- Payment: MPP
- Status: unknown
- Last checked: 2026-10-14
- 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-stock-financial-screener-e8b3427b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_pmdIegvoPKmTqc5Ckl3s1

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-stock-financial-screener-e8b3427b -d '<json body>'
```

Example prompt: Screen for stocks where revenue is greater than $1 billion, net income is positive, and return up to 20 results — I'm looking for large profitable companies to analyze.

## When to prefer this

Use this endpoint when you need to discover or filter stocks based on quantitative financial criteria from official financial statements — ideal for fundamental analysis, investment screening, and building watchlists. Prefer this over general web search when you need structured, comparable financial data with precise threshold conditions across multiple metrics simultaneously.

## Known failure modes

- Invalid operator used with non-ticker/CIK field returns an error
- Using 'in' operator on financial metric fields instead of ticker/CIK causes rejection
- Empty filters array rejected (minimum 1 filter required)
- Unknown or misspelled financial metric field names return no results or an error
- Value type mismatch (e.g., passing string instead of number for numeric operators) causes failure
- No matching companies for overly restrictive filter combinations returns empty results array

## How this service works

Search for stocks by filtering across financial metrics from income statements, balance sheets, and cash flow statements.

<!-- 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 matching companies, each with their ticker symbol, reporting period date, period type (annual, quarterly, or TTM), currency, and any additional financial metric fields that matched the filter criteria.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "filters"
 ],
 "properties": {
  "limit": {
   "type": "integer",
   "default": 10,
   "minimum": 1,
   "description": "The maximum number of results to return."
  },
  "filters": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "field",
     "operator",
     "value"
    ],
    "properties": {
     "field": {
      "type": "string",
      "description": "The criteria to filter on.  For financial metric fields, use 'gt', 'lt', 'gte', 'lte', 'eq' operators.  For 'ticker' and 'cik' fields, use the 'in' operator to filter against multiple values."
     },
     "value": {
      "oneOf": [
       {
        "type": "number",
        "description": "The value to compare against for single-value operators (gt, lt, gte, lte, eq)"
       },
       {
        "type": "array",
        "items": {
         "type": "string"
        },
        "description": "Array of ticker or cik values to compare against when using the 'in' operator"
       }
      ]
     },
     "operator": {
      "enum": [
       "gt",
       "lt",
       "gte",
       "lte",
       "eq",
       "in"
      ],
      "type": "string",
      "description": "The comparison operator. The 'in' operator can only be used with a field value of 'ticker' or 'cik' and lets you filter against multiple values."
     }
    }
   },
   "minItems": 1,
   "description": "An array of filter objects to apply to the search."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "search_results": {
   "type": "array",
   "items": {
    "type": "object",
    "properties": {
     "period": {
      "enum": [
       "annual",
       "quarterly",
       "ttm"
      ],
      "type": "string",
      "description": "The time period of the financial data."
     },
     "ticker": {
      "type": "string",
      "description": "The ticker symbol of the company."
     },
     "currency": {
      "type": "string",
      "description": "The currency of the financial data."
     },
     "report_period": {
      "type": "string",
      "format": "date",
      "description": "The reporting period of the financial data."
     }
    },
    "additionalProperties": {
     "type": "string",
     "description": "Additional financial metrics based on the search criteria."
    }
   }
  }
 }
}
```

## More

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