Fundamentals screener
stocks_screenerScreen all companies by a financial concept (e.g., Revenues) for a specific fiscal period (e.g., FY2023), returning each filer's reported value in one request.
Instructions
Screen one XBRL concept for a single fiscal period across all filers at once (e.g. Revenues for FY2023), returning each company's reported value. This is the cross-sectional counterpart to stocks_financial_concept, which returns one company's series over time. Paginate with cursor/limit.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"concept": "<concept>",
"period": "<period>"
},
"name": "stocks_screener"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| unit | No | Unit filter. Default USD. | |
| limit | No | Page size (endpoint-specific default and max). | |
| cursor | No | Opaque cursor from a previous response's meta.next_cursor. | |
| period | Yes | Fiscal period, e.g. FY2023 or 2023Q4 (as documented). | |
| concept | Yes | XBRL concept name, e.g. Revenues. | |
| taxonomy | No | Concept namespace. Default us-gaap. |