{"quote":{"path":"/fa/quote","method":"POST","kind":"data","tier":"basic","description":"Fetch a fundamentals snapshot for a symbol (price, shares, mcap, debt, EPS, growth).","parameters":{"symbol":{"type":"string","description":"Ticker, e.g. TSLA or HSCL.NS"},"sector":{"type":"string","enum":["non_financials","financials"]}},"required":["symbol"],"output_example":{"symbol":"TSLA","price":250.0,"shares_outstanding":3180000000,"market_cap":795000000000,"source":"Yahoo quoteSummary"},"latency_class":"fast"},"prices":{"path":"/fa/prices","method":"POST","kind":"data","tier":"basic","description":"Fetch price history for a symbol as a canonical series (dates + prices).","parameters":{"symbol":{"type":"string"},"interval":{"type":"string","enum":["1d","1wk","1mo"]},"range_":{"type":"string","description":"e.g. 3y, 1y, 6mo"},"adjusted":{"type":"boolean"}},"required":["symbol"],"output_example":{"symbol":"TSLA","periodicity":"daily","dates":["2026-01-02","2026-01-03"],"prices":[400.0,402.5],"source":"Yahoo v8 chart"},"latency_class":"fast"},"benchmark":{"path":"/fa/benchmark","method":"POST","kind":"data","tier":"basic","description":"Fetch the matching index series (^NSEI for Indian names, ^GSPC otherwise).","parameters":{"symbol":{"type":"string"},"benchmark":{"type":"string","description":"optional override, e.g. ^GSPC"}},"required":["symbol"],"output_example":{"benchmark_for":"TSLA","symbol":"^GSPC","dates":["2026-01-02"],"prices":[5900.0],"source":"Yahoo v8 chart"},"latency_class":"fast"},"rates":{"path":"/fa/rates","method":"POST","kind":"data","tier":"basic","description":"Fetch a risk-free rate snapshot (US 10y/3m or INR 10y G-sec).","parameters":{"rf":{"type":"string","enum":["usd","inr"]},"tenor":{"type":"string","enum":["10y","3m"]}},"required":["rf"],"output_example":{"rf_annual":0.045,"rf_tenor":"10y","rf_source":"Yahoo ^TNX (10y UST)","source":"Yahoo v8 chart"},"latency_class":"fast"},"news":{"path":"/fa/news","method":"POST","kind":"data","tier":"basic","description":"Fetch recent headlines for a ticker / pair / topic.","parameters":{"query":{"type":"string","description":"e.g. TSLA or 'USD/JPY'"},"days":{"type":"integer"},"limit":{"type":"integer"}},"required":["query"],"output_example":{"query":"TSLA","count":12,"source":"Google News RSS","items":[{"title":"...","link":"..."}]},"latency_class":"fast"},"screen":{"path":"/fa/screen","method":"POST","kind":"data","tier":"basic","description":"Resolve a company name to its screener tickers/slugs.","parameters":{"query":{"type":"string"},"limit":{"type":"integer"}},"required":["query"],"output_example":{"query":"Himadri","source":"screener.in search API","matches":[{"name":"Himadri Speciality Chemical","slug":"/company/..."}]},"latency_class":"fast"},"filings":{"path":"/fa/filings","method":"POST","kind":"data","tier":"basic","description":"Fetch recent exchange filings for an NSE symbol (primary evidence).","parameters":{"symbol":{"type":"string"},"limit":{"type":"integer"}},"required":["symbol"],"output_example":{"symbol":"HSCL","source":"NSE corporate-announcements API","count":8,"items":[{"date":"2026-06-17","category":"corporate-announcement"}]},"latency_class":"fast"},"risk":{"path":"/fa/risk","method":"POST","kind":"compute","tier":"basic","description":"Return/risk metrics from a series (CAGR, vol, Sharpe, Sortino, MDD, beta, alpha…).","parameters":{"series":{"type":"object","description":"{symbol, periodicity, dates[], prices[]}"},"benchmark":{"type":"object"},"assumptions":{"type":"object"}},"required":["series"],"output_example":{"cagr_pct":18.4,"vol_pct":32.1,"sharpe":0.57,"beta":1.4,"max_drawdown_pct":28.0,"formulas_used":["sharpe","beta","mdd"]},"latency_class":"fast"},"statements":{"path":"/fa/statements","method":"POST","kind":"compute","tier":"basic","description":"Financial-statement engine: common-size, ratios, DuPont 5-way, FCF, CCC.","parameters":{"statements":{"type":"object","description":"{income_statement, balance_sheet, cash_flow}"},"prior":{"type":"object"}},"required":["statements"],"output_example":{"roe_pct":22.1,"dupont":{"margin_pct":9.0,"turnover":0.7,"leverage":3.5},"fcf_m":12000,"formulas_used":["dupont","fcf"]},"latency_class":"fast"},"multiples":{"path":"/fa/multiples","method":"POST","kind":"compute","tier":"basic","description":"EV assembly + valuation multiples with market-cap reconciliation.","parameters":{"fundamentals":{"type":"object","description":"{symbol, sector, price, shares_outstanding}"},"assumptions":{"type":"object"}},"required":["fundamentals"],"output_example":{"ev":820000000000,"pe_ttm":65.2,"pb":9.8,"ev_ebitda":38.4,"formulas_used":["ev","pe","ev_ebitda"]},"latency_class":"fast"},"factor":{"path":"/fa/factor","method":"POST","kind":"compute","tier":"basic","description":"Correlation, covariance, single-factor OLS, z-scores, rolling stats.","parameters":{"series":{"type":"object","description":"{symbol, periodicity, dates[], prices[]}"},"assumptions":{"type":"object"},"benchmark":{"type":"object"},"rolling":{"type":"integer"}},"required":["series"],"output_example":{"correlation":0.82,"beta":1.4,"alpha":0.02,"z_scores":[0.5,-1.2,0.8],"formulas_used":["ols","corr"]},"latency_class":"fast"},"validate":{"path":"/fa/validate","method":"POST","kind":"validate","tier":"basic","description":"Validate an input document against the canonical schema (correct the request before paying for compute).","parameters":{"document":{"type":"object"},"kind":{"type":"string","enum":["series","fundamentals","statements"]}},"required":["document"],"output_example":{"status":"ok","kind":"fundamentals","valid":true},"latency_class":"fast"},"knowledge":{"path":"/fa/knowledge","method":"POST","kind":"helper","tier":"basic","description":"Retrieve the service's methodology corpus (source registry, conventions, workflows, verification rules).","parameters":{"query":{"type":"string"},"limit":{"type":"integer"}},"required":["query"],"output_example":{"query":"valuation workflow","count":2,"chunks":[{"topic":"valuation-workflow","text":"..."}]},"latency_class":"fast"},"snapshot":{"path":"/fa/snapshot","method":"POST","kind":"assembly","tier":"basic","description":"One structured packet: quote + 1y prices + news + valuation multiples for a fast read.","parameters":{"symbol":{"type":"string"},"sector":{"type":"string"}},"required":["symbol"],"output_example":{"symbol":"TSLA","fundamentals":{"price":250.0},"valuation":{"pe_ttm":65.2},"recent_news":{"count":10}},"latency_class":"medium"},"fa_ask":{"path":"/fa/ask","method":"POST","kind":"assembly","tier":"exclusive","description":"One-call structured financial analysis. DeepSeek orchestrates the tool operations and returns a structured report (snapshot, valuation, statements, flags, caveats, bottom line).","parameters":{"question":{"type":"string","description":"Ask the analyst anything."},"mode":{"type":"string","enum":["snapshot","valuation","risk","fundamentals","forensic","auto"],"description":"Request type (default auto)"}},"required":["question"],"output_example":{"question":"Should I buy TSLA?","report":{"markdown":"## snapshot\n..."},"tools_used":["fa_quote","fa_multiples"],"turns_taken":2},"latency_class":"slow"},"dcf":{"path":"/fa/dcf","method":"POST","kind":"compute","tier":"basic","description":"Deterministic DCF / reverse-DCF from caller-supplied fundamentals + assumptions. 10y explicit FCFF path, PV-vs-terminal split, WACC x g sensitivity grid; reverse mode returns the market-implied terminal FCFF / revenue and breakeven capex ratio.","parameters":{"fundamentals":{"type":"object","description":"{revenue (latest actual), shares_outstanding, cash, debt, tax_rate}"},"assumptions":{"type":"object","description":"{revenue_path[], wacc, terminal_growth, ebitda_margin_path[]|ebitda_margin, capex_pcts[]|capex_pct, wc_pct_of_growth, da_lag, da_rev_pct, years[], mode, target_ev, terminal_fcff_margin}"}},"required":["fundamentals","assumptions"],"output_example":{"ev":820000000000,"per_share":173.0,"pv_terminal":520000000000,"terminal_pct_of_ev":63.4},"latency_class":"fast"},"cross_verify":{"path":"/fa/cross_verify","method":"POST","kind":"compute","tier":"basic","description":"Run deterministic cross-verification checks (market_cap, dupont_roe, ebitda_bridge, eps_bridge) with the contract's hard-fail thresholds. Each check: {name, a, b, [threshold]}.","parameters":{"checks":{"type":"array","description":"[{name: market_cap|dupont_roe|ebitda_bridge|eps_bridge, a, b}]"}},"required":["checks"],"output_example":{"all_passed":true,"checks":[{"name":"market_cap","status":"verified","delta_pct":1.2}]},"latency_class":"fast"},"sources":{"path":"/fa/sources","method":"POST","kind":"helper","tier":"basic","description":"List the service's data sources and their reliability ratings.","parameters":{},"required":[],"output_example":{"sources":[{"name":"yahoo_chart","kind":"prices","reliability":"high"}]},"latency_class":"fast"}}