Company screener: find companies by their fundamentals
Screen listed companies by their newest fiscal year, quarter or trailing four quarters across the filings registries, through REST and MCP.
Screen listed companies by their newest fiscal year, quarter or trailing four quarters across the filings registries, through REST and MCP.
What changed
- Added POST /v1/companies/screen and the MCP tool filings_screen_companies: up to 20 filters on fields such as revenue, net margin, return on equity and debt to equity, an order, the fields to return and a page of up to 100 companies. as_of screens the companies as they stood on a past month end.
- Added GET /v1/companies/screen/filters and the MCP tool filings_get_screen_filters: every field with its type, unit and operators, and the currencies and registries held. It is free.
- Added POST /v1/companies/line-items and the MCP tool filings_search_line_items: chosen line items for up to 10 companies in one request. It costs one call for each company found, and a request that finds none is free.
- A screen is billed by the companies in the page it returns: one Companies call, $0.01, for every 10 companies, rounded up. 1 to 10 companies is $0.01, 11 to 20 is $0.02 and a full page of 100 is $0.10. A screen that matches nothing is free, and so is every error. Each page is billed by its own rows, so the price per company is the same whatever limit you use. The cost of a request is in the X-Narwhal-Cost header.
Was this page helpful?