Skip to main content
POST
Search Stock Financials
Find tickers that match numeric conditions. Body takes filters — each a field, an operator and a value — plus limit. Returns results with ticker, currency, sector, industry and whichever filtered field was matched. This is the only tool here that works without knowing a ticker in advance; everything else takes one as input. Filterable fields are the metric names get_financial_financial_metrics returns. Use it to build a candidate list, then pull detail on each name with the statement or metric tools.
First time? Point any MCP client at https://mcp.aisa.one/mcp — Claude Code, Codex, Cursor, VS Code and the rest. Authorization is OAuth: the client opens a browser, you click Allow once, and there is no key to paste. Your agent then reaches every endpoint through a few meta tools: search, list_categories, get_details and batch_quote are free, batch_use is billed per call. Setup per client is in Connect via MCP; the live tool list and what each call costs are on aisa.one/mcp.
Set this endpoint up in your agent →

Request contract

  • Method and path: POST /apis/v1/financial/financials/search/screener
  • Availability: enabled
  • Request URL template: https://api.aisa.one/apis/v1/financial/financials/search/screener
Complete OpenAPI definition Effective request declaration (including authentication and referenced schemas):

Cost and request rules

Request pricing. Default request estimate: $0.02 USD. The final charge depends on actual usage. Your account price may differ; use a request quote where supported.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
filters
object[]
required

An array of filter objects to apply to the search.

Minimum array length: 1
limit
integer
default:10

The maximum number of results to return.

Required range: x >= 1

Response

Successful search response

search_results
object[]