Screener Search
screener_searchFilter stocks across US, HK, CN, and SG markets by fundamental and technical criteria. Use saved strategies or define custom conditions with keys like PE ratio, RSI, and MACD.
Instructions
Screen stocks. market: US|HK|CN|SG (Mode B required; Mode A uses strategy's market). Mode A: strategy_id from screener_recommend_strategies — auto-runs saved strategy. Mode B: conditions=[{"key":"KEY","min":"10","max":"50","tech_values":{}},...]. extra_returns=["key",...] adds display-only columns. sort_by_key: key name to sort by; sort_order: asc|desc (default desc). page: 0-based (default 0). Returns {total, items[]{symbol, name, indicators[]{key, name, value, unit}}}. Fundamental keys: pettm pbmrq roe roa netmargin salesgrowthyoy netincomegrowthyoy marketcap(亿) circulating_marketcap(亿) prevclose prevchg(%) divyld la epsttm netincome(亿) sales(亿) turnover_rate balance(万). Technical keys (call screener_indicators for tech_values schema): macd_day/week rsi_day/week kdj_day/week boll_day/week.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| market | No | Market: "US" | "HK" | "CN" | "SG". Mode A: overridden by the market embedded in the strategy; pass any value or omit. Mode B: required — determines which market to screen. | |
| strategy_id | No | Mode A — Strategy ID from screener_recommend_strategies screeners[].id. The tool auto-fetches the strategy and builds filters. Omit for Mode B. | |
| conditions | No | Mode B — Filter conditions as objects, passed directly to the API. Each item: {"key": "KEY", "min": "10", "max": "50", "tech_values": {}} The "filter_" prefix is added automatically to the key if missing. Fundamental keys (pass with or without filter_ prefix): pettm pbmrq roe roa netmargin salesgrowthyoy netincomegrowthyoy marketcap(亿) circulating_marketcap(亿) prevclose prevchg(%) divyld la epsttm netincome(亿) sales(亿) turnover_rate balance(万) Technical indicator keys (tech_values required; call screener_indicators for schema): macd_day/week → {"category":"goldenfork"|"deadcross","period":"day"|"week"} rsi_day/week → {"value_type":"overbought"|"oversold"} kdj_day/week → {"category":"goldenfork"|"deadcross"} boll_day/week → {"category":"breakthrough_up"|"breakthrough_down"} | |
| extra_returns | No | Extra indicator keys to include in each result row (display-only, not used as filters). Same key naming as conditions (filter_ prefix added automatically). Example: ["marketcap", "prevclose", "epsttm"] | |
| sort_by_key | No | Indicator key to sort results by (e.g. "marketcap", "roe"). Defaults to the first condition key. Must be one of the condition or extra_returns keys. | |
| sort_order | No | Sort order: "asc" | "desc" (default: "desc") | |
| page | No | Page number, 0-based (default: 0) | |
| size | No | Page size (default: 20, max: 100) |