Get Stock Financials
finance_stock_financialsRead-onlyIdempotent
Retrieve financial statements including income statements, balance sheets, and cash flow data for stock analysis. Powered by x402 USDC micropayments on Base.
Instructions
Get financial statements: income statement, balance sheet, and cash flow data. Costs $0.10 USDC per request via x402 on Base.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| symbol | Yes | Stock ticker (e.g., AAPL, MSFT, GOOGL) |
Implementation Reference
- src/index.ts:161-176 (handler)Registration and implementation of the 'finance_stock_financials' tool. The handler calls the finance API endpoint /api/v1/stocks/financials/{symbol} and returns the data as text.
server.registerTool( "finance_stock_financials", { title: "Get Stock Financials", description: `Get financial statements: income statement, balance sheet, and cash flow data. Costs $0.10 USDC per request via x402 on Base.`, inputSchema: { symbol: z.string().min(1).max(10).describe("Stock ticker (e.g., AAPL, MSFT, GOOGL)"), }, annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true }, }, async ({ symbol }) => { const data = await apiFetch(`${FINANCE_API}/api/v1/stocks/financials/${symbol.toUpperCase()}`); return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] }; } );