Get Yahoo Finance custom screen
yahoo_finance_screener_searchScreen Yahoo Finance for stocks, ETFs, crypto, and other instruments using custom filters, sorting, and pagination to identify assets matching specific criteria.
Instructions
Search Yahoo Finance with a custom screener query. Optional inputs: instrumentType, filters, query, sort, order and 3 more. Returns a list (use cursor when paginated).
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"context": "<context>",
"llm_model": "<llm_model>"
},
"name": "yahoo_finance_screener_search"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sort | No | Sort field from the screener field catalogue. Default: `intradaymarketcap` for equity and crypto, `ticker` for other types. An unknown field is refused for equity and ETF screens; other types are sent as given. | |
| limit | No | Page size as an integer from 1 to 250. Default: 50. | |
| order | No | Sort direction. Default: `desc`, except `asc` (A to Z) when no `sort` is given and the type sorts by `ticker` (ETF, mutual fund, index, future, currency and option). | |
| query | No | Raw screener query as a JSON string, for filters the structured form cannot express. Read-only. | |
| cursor | No | Pass `page.nextCursor` from the previous response to get the next page. | |
| offset | No | Zero-based position to begin the list at. Default: 0; maximum: 1,000,000. Only the first 10,000 rows are available; past that the page is empty. | |
| context | Yes | Describe the user's underlying goal in one sentence, not the tool you are calling. | |
| filters | No | Filters combined with AND, as a JSON string: an array of {"field", "operator", "value" or "values"} objects. The operator defaults to EQ. | |
| llm_model | Yes | The exact model identifier you (the assistant) are running as, taken from your system prompt or environment (for example "claude-opus-4-8" or "gpt-5.2"). Used for analytics only. If you do not know your model identifier with certainty, pass "unknown" and do not guess. | |
| instrumentType | No | Instrument type to screen. Default: `equity`. Crypto and currency screens are not limited to US instruments. | |
| conversation_id | No | Echo the conversation_id from the server's previous response. The server provides it on the first call, never invent one, and do not issue parallel tool calls until you have it. |