screen_stocks
Filter stocks by exchange, country, and financial metrics to identify securities matching your criteria. Retrieve customizable market data for NYSE, NASDAQ, and global equities.
Instructions
Stock Screener. Retrieve stock data based on specified filter criteria → Returns {hasNext: boolean, current_page: number, total_page: number, current_items: number, data: [{symbol_code: string, name: string, country: string, currency: string, delay_seconds: number, ...requested_fields}]}. WORKFLOW: 1) Call get_stock_screener_params to discover available fields, exchanges, countries. 2) POST with your chosen fields. Tip: Filter by exchanges (e.g., ["NYSE", "NASDAQ"]) to exclude OTC/penny stocks. Example: {"fields":["close","volume","market_cap"],"exchanges":["NYSE","NASDAQ"],"countries":["US","CA"],"page":1,"ignore_invalid":false,"sortBy":"market_cap","sortOrder":"desc"}. Returns up to 1000 results per page.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| fields | Yes | Array of field names to include in the response (1-10 fields). Discover available fields by calling the GET screener params tool first (e.g., get_stock_screener_params). Field names are case-insensitive. | |
| exchanges | No | Array of exchange names to filter by (e.g., ["NYSE", "NASDAQ"]). Discover available exchanges via the GET screener params tool. | |
| ignore_invalid | No | If true, invalid fields, exchanges, or countries are silently filtered out instead of returning an error. Useful when you're unsure if a field exists. | |
| countries | No | Array of country codes to filter by (e.g., ["US", "CA"]). Not available for crypto screener. Discover available countries via the GET screener params tool. | |
| page | No | Page number for pagination | |
| sortBy | No | Field name to sort results by. Must be one of the requested fields or "name". Default: "name". | |
| sortOrder | No | Sort order: "asc" (ascending) or "desc" (descending). Default: "asc". | |
| filter | No | (Optional) JSONata expression to filter/transform the API response server-side before it reaches you. Use this to extract only the fields or rows you need, reducing token usage. See https://jsonata.org for syntax. |