Screen Taiwan stocks
screen_stocksFilter TWSE and TPEx stocks by end-of-day price, change, volume, turnover, valuation (P/E, dividend yield, P/B), and monthly revenue growth using optional min/max bounds; sort and limit results.
Instructions
Filter all TWSE and TPEx stocks by end-of-day price, change, volume and turnover, and by valuation (P/E, dividend yield, P/B) and monthly revenue growth. Every filter is an optional min_/max_ bound, e.g. {"min_dividend_yield": 5, "max_pe_ratio": 15, "min_turnover": 100000000}. Rows missing a filtered metric are excluded. Defaults to common stocks only; results are sorted by sort_by (default turnover, descending). Price filters use the latest (or given) trading day; fundamental filters always use the latest published snapshot, so date cannot be combined with them.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "screen_stocks"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| date | No | Trading date for price filters. Not allowed with fundamental filters. | |
| limit | No | Rows to return. Default 20. | |
| order | No | Default "desc". | |
| types | No | Default ["stock"]. Add "etf" to include ETFs. | |
| market | No | Omit for both markets. | |
| sort_by | No | Default "turnover". | |
| max_price | No | Maximum Closing price, TWD | |
| min_price | No | Minimum Closing price, TWD | |
| max_volume | No | Maximum Shares traded | |
| min_volume | No | Minimum Shares traded | |
| max_pb_ratio | No | Maximum Price/book ratio | |
| max_pe_ratio | No | Maximum Price/earnings ratio on the latest four quarters of EPS (only companies with positive earnings have one) | |
| max_turnover | No | Maximum Turnover, TWD | |
| min_pb_ratio | No | Minimum Price/book ratio | |
| min_pe_ratio | No | Minimum Price/earnings ratio on the latest four quarters of EPS (only companies with positive earnings have one) | |
| min_turnover | No | Minimum Turnover, TWD | |
| max_revenue_yoy | No | Maximum Latest monthly revenue growth year over year, % | |
| min_revenue_yoy | No | Minimum Latest monthly revenue growth year over year, % | |
| max_change_percent | No | Maximum Daily change, % | |
| max_dividend_yield | No | Maximum Dividend yield, %, on the latest annual dividend; above 20% is usually a one-off distribution (flagged in notes) | |
| min_change_percent | No | Minimum Daily change, % | |
| min_dividend_yield | No | Minimum Dividend yield, %, on the latest annual dividend; above 20% is usually a one-off distribution (flagged in notes) |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| date | Yes | Trading date of the price data | |
| notes | Yes | ||
| filters | Yes | The bounds that were applied | |
| matched | Yes | Rows that passed every filter (before limit) | |
| results | Yes |