← All toolsFinance & Analysisanalyst_toolsAll editions

GET_FINANCIALS

Pulls REAL historical financial statements (income statement, balance sheet, cash flow) for a public company using Yahoo Finance. Returns 4 years of annual data with revenue, net income, EBITDA, total assets, debt, operating cash flow, etc. Use this FIRST for any financial data request instead of web search.

Parameters

NameTypeRequiredDescription
tickerstringyesStock ticker symbol (e.g., 'AAPL', 'MSFT', 'GOOGL')
statementsarray—Which statements to fetch: 'income', 'balance', 'cashflow'. Default: all three.

How to use it

You normally trigger this by describing what you want in chat — the agent selects GET_FINANCIALS automatically. For example:

Try saying
“get my analyst tools”

In a workflow

As a step in a multi-step workflow DAG:

json
{
  "id": "s1",
  "agent": "analyst_tools",
  "action": "GET_FINANCIALS",
  "args": {
    "ticker": "…",
    "statements": []
  },
  "depends_on": [],
  "outputs": []
}

Direct call

For scripting, call it directly via POST /execute_tool. Every tool returns { success, message, data }.

bash
curl -X POST http://127.0.0.1:8000/execute_tool \
  -H "Content-Type: application/json" \
  -d '{"tool_name":"GET_FINANCIALS","args":{"ticker":"…","statements":[]}}'

Part of the analyst_tools plugin. Browse the full Plugin & Tool Catalog or the relevant feature guide.