Screen stocks
screen_stocksRead-only
Screen global stocks by applying fundamental rules. Filter by sector, industry, country, and compare growth or value metrics to get a compact table of matching stocks.
Instructions
Screen the global Bullrun stock universe with the same rule engine as the app screener. Filter by sector, industry, country/countries, primary vs secondary listings, active vs inactive listings, lookback mode, AND/OR rule groups, comparison operators, money units, growth metrics and latest-value metrics. Returns a compact table of matching stocks. Read-only.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mode | No | Deprecated alias for lookbackMode; kept for compatibility. | |
| limit | No | Maximum number of stocks to return (1-100). | |
| order | No | Sort direction. Nulls always sort last regardless of direction. | desc |
| rules | No | Fundamental rules. Same groupId means AND; different groupIds mean OR. | |
| sector | No | Exact sector name to filter by, e.g. "Technology", "Healthcare". Omit for all sectors. | |
| sortBy | No | Metric to sort by. revenueGrowth is accepted as an alias for revenueGrowthPct. | marketCap |
| country | No | Exact country name to filter by, e.g. "United States", "Germany". Omit for all countries. | |
| periods | No | Deprecated alias for lookback; kept for compatibility. | |
| industry | No | Exact industry name to filter by, e.g. "Software - Infrastructure". Omit for all industries. | |
| lookback | No | How many reporting periods to evaluate. Growth rules need at least 2 comparable periods. | |
| countries | No | Exact country names to include. Use this for multi-country screens; it overrides country when provided. | |
| lookbackMode | No | Whether rule evaluation uses annual or quarterly reporting periods. | annual |
| minMarketCap | No | Compatibility shortcut: adds marketCap >= this absolute value to every rule group. | |
| includeInactive | No | Include delisted/inactive tickers with no recent price bar. Default false. | |
| includeSecondary | No | Include secondary cross-listings of the same security. Default false (primary listings only). |