list_tickers
Search and list available financial tickers by market, security type, or search query to identify trading instruments for market analysis.
Instructions
Search/list available tickers
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| search | No | Search query | |
| type | No | Security type | |
| market | No | Market type | |
| limit | No | Number of results (default: 100) |
Implementation Reference
- src/index.ts:187-213 (handler)The main handler function for the 'list_tickers' tool. It constructs query parameters from input args and fetches the list of tickers from the Polygon API endpoint '/v3/reference/tickers', returning the JSON response or an error message.
list_tickers: async (args: { search?: string; type?: string; market?: string; limit?: number }) => { try { const params: any = { limit: args.limit || 100, active: true }; if (args.search) params.search = args.search; if (args.type) params.type = args.type; if (args.market) params.market = args.market; const response = await polygonApi.get('/v3/reference/tickers', { params }); return { content: [{ type: "text", text: JSON.stringify(response.data, null, 2) }] }; } catch (error: any) { return { content: [{ type: "text", text: `Error listing tickers: ${error.response?.data?.message || error.message}` }], isError: true }; } }, - src/index.ts:359-381 (schema)Input schema definition for the 'list_tickers' tool, specifying optional parameters for search query, security type, market, and limit with enums for type and market.
inputSchema: { type: "object", properties: { search: { type: "string", description: "Search query" }, type: { type: "string", enum: ["CS", "ADRC", "ADRP", "ADRR", "UNIT", "RIGHT", "PFD", "FUND", "SP", "WARRANT", "INDEX", "ETF", "ETN", "OS", "GDR", "OTHER", "NYRS", "AGEN", "EQLK", "BOND", "ADRW", "BASKET"], description: "Security type" }, market: { type: "string", enum: ["stocks", "crypto", "fx", "otc", "indices"], description: "Market type" }, limit: { type: "number", description: "Number of results (default: 100)" } } } - src/index.ts:356-382 (registration)Registration of the 'list_tickers' tool in the ListToolsRequestSchema handler response, including name, description, and full input schema.
{ name: "list_tickers", description: "Search/list available tickers", inputSchema: { type: "object", properties: { search: { type: "string", description: "Search query" }, type: { type: "string", enum: ["CS", "ADRC", "ADRP", "ADRR", "UNIT", "RIGHT", "PFD", "FUND", "SP", "WARRANT", "INDEX", "ETF", "ETN", "OS", "GDR", "OTHER", "NYRS", "AGEN", "EQLK", "BOND", "ADRW", "BASKET"], description: "Security type" }, market: { type: "string", enum: ["stocks", "crypto", "fx", "otc", "indices"], description: "Market type" }, limit: { type: "number", description: "Number of results (default: 100)" } } } },