Skip to main content

​
Overview

The yf_sector tool provides detailed information about market sectors including performance metrics, top companies, research reports, and related investment products.

​
Tool Name

yf_sector

​
Parameters

​
key
string
required
Sector key identifier (e.g., ‘technology’, ‘healthcare’, ‘financial-services’)
​
field
enum
Specific sector field to retrieve. Available fields:
  • key - Sector key identifier
  • name - Sector display name
  • symbol - Sector symbol
  • ticker - Sector ticker representation
  • overview - Comprehensive sector overview and statistics
  • top_companies - List of leading companies in the sector
  • research_reports - Available research reports for the sector
  • top_etfs - Top-performing ETFs tracking the sector
  • top_mutual_funds - Top mutual funds focused on the sector
  • industries - Industries contained within the sector
​
response_format
enum
default:"json"
Output format:
  • json - Structured JSON data
  • markdown - Formatted markdown tables
​
preview_limit
number
default:25
Number of rows to preview (1-200) when using markdown format
​
save
object
Save options for exporting data:

​
Common Sector Keys

  • technology - Technology sector
  • healthcare - Healthcare sector
  • financial-services - Financial Services
  • consumer-cyclical - Consumer Cyclical
  • consumer-defensive - Consumer Defensive
  • industrials - Industrials sector
  • energy - Energy sector
  • utilities - Utilities sector
  • real-estate - Real Estate
  • basic-materials - Basic Materials
  • communication-services - Communication Services

​
Field Details

​
Overview

Provides comprehensive sector statistics including:
  • Market capitalization
  • Performance metrics (1D, 1W, 1M, 3M, YTD, 1Y)
  • Valuation ratios (P/E, P/B, P/S)
  • Profitability metrics

​
Top Companies

Returns a list of the largest and most significant companies within the sector, including:
  • Company name and ticker
  • Market capitalization
  • Performance data

​
Industries

Lists all industries that compose the sector, useful for drilling down to more granular analysis.

​
Investment Products

top_etfs and top_mutual_funds provide curated lists of investment vehicles that track sector performance.

​
Usage Examples

{
  "key": "technology",
  "field": "overview",
  "response_format": "json"
}

Build docs developers (and LLMs) love

Get started for freeTalk to us