# TotalFinance > TotalFinance is an open-source TypeScript financial-computation toolkit by InsiderFinance: options, strategies, volatility, technical analysis, portfolio P&L, performance, risk, valuation, fixed income, FX, commodities, crypto and backtesting. It computes on caller-supplied data (it never fetches quotes), uses explicit units (decimals for rates and volatility, year fractions and epoch milliseconds for time), and returns assumptions and diagnostics with every explained answer. Docs: https://www.totalfinance.io/docs/totalfinance · Package: `@insiderfinance/totalfinance` (Development · 0.1.5 · unpublished) · Source: https://github.com/InsiderFinance/totalfinance ## Use TotalFinance as tools (MCP) - Calculations (`totalfinance`, local stdio): `node /absolute/path/to/totalfinance/distribution/mcp/dist/bin.js` after building from source (not on npm yet). The TotalFinance MCP server runs the library on your machine: pricing, Greeks, strategies, volatility, technical analysis, risk, bonds and more, read-only by default. - Docs (`totalfinance-docs`, hosted, Streamable HTTP): https://www.totalfinance.io/docs/totalfinance/mcp. These docs as a hosted MCP server: search them, read any page and fetch the full contract of any export, so your agent writes code against the real API. Nothing to install. - Exact setup for Claude Code, Claude Desktop, Cursor, VS Code, Codex, Windsurf, Gemini CLI and ChatGPT: [Connect an AI agent](https://www.totalfinance.io/docs/totalfinance/agents.md). Every page below is Markdown. For one library module in a single file, use its bundle under "Library bundles". ## Start here - [TotalFinance](https://www.totalfinance.io/docs/totalfinance/start.md): Open-source TypeScript finance with explicit units, honest assumptions and diagnostics you can read. Built by InsiderFinance. - [Core concepts](https://www.totalfinance.io/docs/totalfinance/start/concepts.md): The few conventions that make every TotalFinance answer readable, checkable and safe to compose. - [Installation](https://www.totalfinance.io/docs/totalfinance/start/installation.md): Add one package, import from domain subpaths, and keep bundles small. - [Quickstart](https://www.totalfinance.io/docs/totalfinance/start/quickstart.md): You do not need to construct a portfolio, register an operation, start a server, or connect a data provider to calculate an option price. Install one domain package and call the function that answers your question. ## Calculators (live in the browser; each page includes its exact TypeScript) - [Analyze an option strategy](https://www.totalfinance.io/docs/totalfinance/learn/analyze-a-strategy.md): Build any multi-leg position, then read its expiration payoff, break-evens and maximum profit and loss. - [Backtest a strategy](https://www.totalfinance.io/docs/totalfinance/learn/backtest-a-strategy.md): Test a moving-average rule on your own price data, with next-bar execution, commissions, equity and drawdown. - [Chart technical indicators](https://www.totalfinance.io/docs/totalfinance/learn/chart-technical-indicators.md): Overlay moving averages or Bollinger Bands and add RSI or MACD on your own price data, with honest warmup. - [Explore scenarios](https://www.totalfinance.io/docs/totalfinance/learn/explore-scenarios.md): Revalue an option position before expiry across underlying prices, volatility shocks and the passage of time. - [Fit a volatility smile](https://www.totalfinance.io/docs/totalfinance/learn/fit-a-volatility-smile.md): Fit SVI, SABR or monotone interpolation to implied-volatility quotes and check the fit for butterfly arbitrage. - [Measure value at risk](https://www.totalfinance.io/docs/totalfinance/learn/measure-risk.md): Historical or parametric VaR and expected shortfall on your own returns, with the loss tail and drawdowns drawn. - [Price a bond](https://www.totalfinance.io/docs/totalfinance/learn/price-a-bond.md): Price a fixed-rate bond from its yield and read duration, convexity and DV01, with the price–yield curve drawn. - [Price an option](https://www.totalfinance.io/docs/totalfinance/learn/price-an-option.md): Black–Scholes–Merton prices and Greeks for a European call or put, with every convention echoed back. - [Track portfolio P&L](https://www.totalfinance.io/docs/totalfinance/learn/track-portfolio-pnl.md): Separate investment profit from deposits with an event-sourced ledger and reconciled P&L. - [Value a company](https://www.totalfinance.io/docs/totalfinance/learn/value-a-company.md): A discounted-cash-flow valuation with a full two-way sensitivity table, where every cell is a real valuation. ## Library bundles (overview + guides + compact reference, sized for a context window) - [Research data](https://www.totalfinance.io/docs/totalfinance/llms/data.txt): Provider-neutral research queries, immutable source views, bounded windows and explicit resume/quality decisions; external packages own acquisition. - [Options](https://www.totalfinance.io/docs/totalfinance/llms/options.txt): Black–Scholes, Black-76, Bachelier, American, Heston, SABR and exotic pricing; Greeks; implied volatility; chain health. - [Strategies](https://www.totalfinance.io/docs/totalfinance/llms/strategy.txt): Multi-leg option positions: payoff, break-evens, scenarios and a named strategy catalogue. - [Volatility](https://www.totalfinance.io/docs/totalfinance/llms/volatility.txt): Realized and implied volatility, smiles and surfaces (SVI, SSVI, SABR, Heston), GARCH. - [Technical analysis](https://www.totalfinance.io/docs/totalfinance/llms/technical-analysis.txt): Hundreds of registered indicators with explicit warmup, streaming state, snapshots and a TA-Lib compatibility matrix. - [Portfolio](https://www.totalfinance.io/docs/totalfinance/llms/portfolio.txt): Event-sourced ledgers, positions, lots, cash, P&L attribution and timelines. - [Performance](https://www.totalfinance.io/docs/totalfinance/llms/performance.txt): Returns, risk-adjusted ratios, drawdowns, benchmarks and sector performance. - [Risk](https://www.totalfinance.io/docs/totalfinance/llms/risk.txt): Value at risk, expected shortfall, covariance, drawdown risk and portfolio optimization. - [Valuation](https://www.totalfinance.io/docs/totalfinance/llms/valuation.txt): DCF, NPV and IRR, WACC, comparables, dividend and residual-income models, loans and price-level conversion. - [Fundamentals](https://www.totalfinance.io/docs/totalfinance/llms/fundamentals.txt): Statement ratios, quality scores (Piotroski, Altman, Beneish), growth and point-in-time availability. - [Fixed income](https://www.totalfinance.io/docs/totalfinance/llms/fixed-income.txt): Bonds, yields, duration and convexity, curves, swaps, caps, swaptions and futures. - [Foreign exchange](https://www.totalfinance.io/docs/totalfinance/llms/foreign-exchange.txt): Conversion, cross rates, forwards, swaps, non-deliverable forwards and hedging. - [Commodities](https://www.totalfinance.io/docs/totalfinance/llms/commodities.txt): Forwards, carry, convenience yield, roll yield, spreads and term structure. - [Crypto](https://www.totalfinance.io/docs/totalfinance/llms/crypto.txt): Perpetual funding, futures basis, carry curves, inverse contracts and liquidation prices. - [Scenarios](https://www.totalfinance.io/docs/totalfinance/llms/scenarios.txt): Scenario runs across priced positions and portfolio scenario targets. - [Exposure & flow](https://www.totalfinance.io/docs/totalfinance/llms/structure.txt): Dealer Greek exposure (gamma, vanna, charm and more), option flow and unusual activity. - [Backtesting](https://www.totalfinance.io/docs/totalfinance/llms/backtest.txt): Vectorized and event-driven backtests, costs, execution and tear sheets. - [Research](https://www.totalfinance.io/docs/totalfinance/llms/research.txt): Screens, factors, event studies and research hygiene. - [Math](https://www.totalfinance.io/docs/totalfinance/llms/math.txt): Distributions, statistics, linear algebra, optimization, root finding and Monte Carlo. - [Calendars](https://www.totalfinance.io/docs/totalfinance/llms/calendars.txt): Exchange calendars (NYSE, Cboe, 24×7 crypto), holidays and option expirations. - [Core](https://www.totalfinance.io/docs/totalfinance/llms/core.txt): Shared errors, conventions, validation, dates, formatting, OCC symbols and artifacts. - [Workflows](https://www.totalfinance.io/docs/totalfinance/llms/workflows.txt): The operation registry behind the CLI, HTTP server and MCP tools. - [CLI](https://www.totalfinance.io/docs/totalfinance/llms/cli.txt): The command-line interface over the operation registry. - [HTTP server](https://www.totalfinance.io/docs/totalfinance/llms/http.txt): A local HTTP/OpenAPI server over the operation registry. - [MCP server](https://www.totalfinance.io/docs/totalfinance/llms/mcp.txt): The optional @insiderfinance/totalfinance-mcp package for AI agents. ## Library overviews - [Library](https://www.totalfinance.io/docs/totalfinance/domains.md): Explore the finance library, common APIs, and the complete reference for every module. - [Backtesting](https://www.totalfinance.io/docs/totalfinance/domains/backtest.md): Vectorized and event-driven backtests, costs, execution and tear sheets. - [Calendars](https://www.totalfinance.io/docs/totalfinance/domains/calendars.md): Exchange calendars (NYSE, Cboe, 24×7 crypto), holidays and option expirations. - [CLI](https://www.totalfinance.io/docs/totalfinance/domains/cli.md): The command-line interface over the operation registry. - [Commodities](https://www.totalfinance.io/docs/totalfinance/domains/commodities.md): Forwards, carry, convenience yield, roll yield, spreads and term structure. - [Core](https://www.totalfinance.io/docs/totalfinance/domains/core.md): Shared errors, conventions, validation, dates, formatting, OCC symbols and artifacts. - [Crypto](https://www.totalfinance.io/docs/totalfinance/domains/crypto.md): Perpetual funding, futures basis, carry curves, inverse contracts and liquidation prices. - [Research data](https://www.totalfinance.io/docs/totalfinance/domains/data.md): Connect independently maintained providers to normalized research data and existing calculations. - [Fixed income](https://www.totalfinance.io/docs/totalfinance/domains/fixed-income.md): Bonds, yields, duration and convexity, curves, swaps, caps, swaptions and futures. - [Foreign exchange](https://www.totalfinance.io/docs/totalfinance/domains/foreign-exchange.md): Conversion, cross rates, forwards, swaps, non-deliverable forwards and hedging. - [Fundamentals](https://www.totalfinance.io/docs/totalfinance/domains/fundamentals.md): Statement ratios, quality scores (Piotroski, Altman, Beneish), growth and point-in-time availability. - [HTTP server](https://www.totalfinance.io/docs/totalfinance/domains/http.md): A local HTTP/OpenAPI server over the operation registry. - [Math](https://www.totalfinance.io/docs/totalfinance/domains/math.md): Distributions, statistics, linear algebra, optimization, root finding and Monte Carlo. - [MCP server](https://www.totalfinance.io/docs/totalfinance/domains/mcp.md): The optional @insiderfinance/totalfinance-mcp package for AI agents. - [Options](https://www.totalfinance.io/docs/totalfinance/domains/options.md): Black–Scholes, Black-76, Bachelier, American, Heston, SABR and exotic pricing; Greeks; implied volatility; chain health. - [Performance](https://www.totalfinance.io/docs/totalfinance/domains/performance.md): Returns, risk-adjusted ratios, drawdowns, benchmarks and sector performance. - [Portfolio](https://www.totalfinance.io/docs/totalfinance/domains/portfolio.md): Event-sourced ledgers, positions, lots, cash, P&L attribution and timelines. - [Research](https://www.totalfinance.io/docs/totalfinance/domains/research.md): Screens, factors, event studies and research hygiene. - [Risk](https://www.totalfinance.io/docs/totalfinance/domains/risk.md): Value at risk, expected shortfall, covariance, drawdown risk and portfolio optimization. - [Scenarios](https://www.totalfinance.io/docs/totalfinance/domains/scenarios.md): Scenario runs across priced positions and portfolio scenario targets. - [Strategies](https://www.totalfinance.io/docs/totalfinance/domains/strategy.md): Multi-leg option positions: payoff, break-evens, scenarios and a named strategy catalogue. - [Exposure & flow](https://www.totalfinance.io/docs/totalfinance/domains/structure.md): Dealer Greek exposure (gamma, vanna, charm and more), option flow and unusual activity. - [Technical analysis](https://www.totalfinance.io/docs/totalfinance/domains/technical-analysis.md): Hundreds of registered indicators with explicit warmup, streaming state, snapshots and a TA-Lib compatibility matrix. - [Valuation](https://www.totalfinance.io/docs/totalfinance/domains/valuation.md): DCF, NPV and IRR, WACC, comparables, dividend and residual-income models, loans and price-level conversion. - [Volatility](https://www.totalfinance.io/docs/totalfinance/domains/volatility.md): Realized and implied volatility, smiles and surfaces (SVI, SSVI, SABR, Heston), GARCH. - [Workflows](https://www.totalfinance.io/docs/totalfinance/domains/workflows.md): The operation registry behind the CLI, HTTP server and MCP tools. ## Guides - [Guides](https://www.totalfinance.io/docs/totalfinance/guides.md): Conventions, workflows and deep dives, generated from the guides in the repository. - [Getting Started](https://www.totalfinance.io/docs/totalfinance/guides/getting-started.md): TotalFinance is an unpublished preview. Until npm publication, use a source checkout; the install commands below describe the planned published experience, not a completed registry installation. - [Assumptions and Conventions](https://www.totalfinance.io/docs/totalfinance/guides/assumptions.md): TotalFinance does not hide finance conventions. Pro APIs return a Computed.json (for example https://www.totalfinance.io/docs/totalfinance/reference/totalfinance/options.json). ## Machine-readable - [Search index](https://www.totalfinance.io/docs/totalfinance/search-index.json) - [Operation catalog](https://www.totalfinance.io/docs/totalfinance/operation-catalog.json): 48 operations with schemas. - [OpenAPI](https://www.totalfinance.io/docs/totalfinance/openapi.json): the local HTTP server. - Docs MCP endpoint (where the host supports functions): https://www.totalfinance.io/docs/totalfinance/mcp ## Optional - [Full reference for LLMs](https://www.totalfinance.io/docs/totalfinance/llms-full.txt): every entry point, type and operation in one large file.