Yfinance

YFinanceTools enable an Agent to access stock data, financial information and more from Yahoo Finance.

Prerequisites

The following example requires the yfinance library.

1uv pip install -U yfinance

Example

The following agent will provide information about the stock price and analyst recommendations for NVDA (Nvidia Corporation).

1from kern.agent import Agent
2from kern.tools.yfinance import YFinanceTools
3
4agent = Agent(
5    tools=[YFinanceTools()],
6    description="You are an investment analyst that researches stock prices, analyst recommendations, and stock fundamentals.",
7    instructions=["Format your response using markdown and use tables to display data where possible."],
8)
9agent.print_response("Share the NVDA stock price and analyst recommendations", markdown=True)

Toolkit Params

The YFinanceTools toolkit does not require any configuration parameters. All functions are enabled by default and do not have individual enable/disable flags. Simply instantiate the toolkit without any parameters.

Toolkit Functions

Function	Description
`get_current_stock_price`	This function retrieves the current stock price of a company.
`get_company_info`	This function retrieves detailed information about a company.
`get_historical_stock_prices`	This function retrieves historical stock prices for a company.
`get_stock_fundamentals`	This function retrieves fundamental data about a stock.
`get_income_statements`	This function retrieves income statements of a company.
`get_key_financial_ratios`	This function retrieves key financial ratios for a company.
`get_analyst_recommendations`	This function retrieves analyst recommendations for a stock.
`get_company_news`	This function retrieves the latest news related to a company.
`get_technical_indicators`	This function retrieves technical indicators for stock analysis.

You can use include_tools or exclude_tools to modify the list of tools the agent has access to. Learn more about selecting tools.

Developer Resources

View Tools