# Changelog

> Release history for TradingCalc: new tools, API changes, and formula updates.

Source: https://docs.tradingcalc.io/changelog

New tools, API changes, and formula updates.

## v3.62.0 (November 2, 2026, feature)

- **new:** Batch call: the tool system.batch runs up to 10 calls in one request and returns every result in order, each with its own signature. Every entry counts as one call against the daily limit; the batch request itself is free.

## v3.61.0 (November 2, 2026, feature)

- **new:** Cash-Secured Put Calculator at /cash-secured-put-calculator and the tool workflow.run_cash_secured_put: premium income, cash held, return for the period and per year, the effective buy price if the shares are assigned, the breakeven and the loss below it, with an optional comparison against buying the shares now.

## v3.60.0 (November 1, 2026, feature)

- **new:** Option Greeks Calculator at /option-greeks-calculator and the tool workflow.run_option_greeks: delta, gamma, vega, theta, rho and the second order Greeks vanna, vomma, charm, veta, speed, zomma and color for a European option with a dividend yield, each checked against QuantLib and 100-digit differentiation on 1000 random options.

## v3.59.0 (November 1, 2026, feature)

- **new:** Bybit options (BTC, ETH, USDT-settled): the option chain in the common shape at /api/market/option-chain?exchange=bybit, and live Black-Scholes in the widget venue switch and in workflow.run_black_scholes_live with exchange "bybit". Bybit prices off the expiry forward with no rate, so the price check uses that forward and a rate of 0.
- **new:** LangChain package langchain-tradingcalc on PyPI: TradingCalcToolkit().get_tools() returns every TradingCalc tool as a LangChain tool, with names that OpenAI and Anthropic function calling accept.

## v3.58.0 (October 31, 2026, feature)

- **new:** Options Strategy Picker (/options-strategy-picker) and the MCP tool workflow.run_strategy_picker: ranks spreads, straddle, strangle, butterfly, iron condor, covered call and protective put for a price target and a volatility view, with legs at the best strikes, expected profit, probability of profit, max profit and loss, breakevens and return on risk. Checked against an independent Python implementation that integrates the payoff numerically.

## v3.57.0 (October 31, 2026, feature)

- **new:** Bond Price Calculator (/bond-price-calculator) and the MCP tool workflow.run_bond_price: the price of a fixed-rate bond at a yield to maturity, with Macaulay and modified duration, convexity and DV01. Checked against an independent Python reference that takes the durations from numerical derivatives of the price.

## v3.56.0 (October 31, 2026, feature)

- **new:** API and MCP reference: connection snippets for Gemini CLI (an httpUrl entry in settings.json) and Google ADK (McpToolset over Streamable HTTP). Each was run as published and returned the same Black-Scholes call price as a direct tools/call.

## v3.55.0 (October 31, 2026, feature)

- **new:** APY and APR Converter (/apy-apr-converter) and the MCP tool workflow.run_apy_apr_converter: convert an APR to an APY or back for the compounding you choose (any periods per year or continuous), with the same APY stated as an APR at seven standard frequencies. Checked against an independent Python reference.

## v3.54.0 (October 31, 2026, feature)

- **improved:** An inverse short whose margin covers any price rise (1x or less with the default maintenance base) cannot be liquidated, so Liquidation Price and the trade workflows now return no liquidation price (null) for it instead of an error.
- **new:** Liquidation Price takes the maintenance margin on the position value at the liquidation price by default, the form published by Bybit, KuCoin and Hyperliquid. New optional inputs: mmBase "entry" (maintenance margin on the entry value, the MEXC form) and liqFeeRate (a liquidation fee added to the rate, as KuCoin charges). The formula is published with all four variants on the methodology page and in llms.txt, and the test vectors grew from 48 to 53.

## v3.53.0 (October 31, 2026, feature)

- **new:** Time Value of Money, the eighth domain: Present Value, Future Value, NPV, IRR and CAGR calculators (/present-value-calculator, /future-value-calculator, /npv-calculator, /irr-calculator, /cagr-calculator) and the MCP tools workflow.run_present_value, workflow.run_future_value, workflow.run_npv, workflow.run_irr and workflow.run_cagr, checked against an independent Python reference. IRR returns no single answer, with the reason, when flows change sign more than once and the root is not unique.

## v3.52.0 (October 30, 2026, feature)

- **new:** Monte Carlo Simulation Calculator (/monte-carlo-simulation-calculator) and workflow.run_monte_carlo: thousands of geometric-Brownian-motion paths for a portfolio with a contribution or withdrawal every period, returning percentile outcomes, the chance of ending below what was put in, the chance of ending a period at or below a ruin level and a fan chart. The same seed gives the same bytes. Checked against an independent Python replay of the identical stream, 2 million numpy paths from a different generator, and closed forms for the mean and the no-contribution case.

## v3.51.0 (October 30, 2026, feature)

- **new:** Binance options in live Black-Scholes: the widget at /black-scholes-calculator has a Deribit / Binance switch, and workflow.run_black_scholes_live and its HTTP route take exchange: "binance" (BTC, ETH, gold and silver contracts, USDT-settled, so the price is in USDT with no coin conversion). It prices the contract from its own index, mark IV and the risk-free rate Binance states for it, and shows the gap to Binance's mark price. Checked on 112 live contracts against an independent Python implementation: the largest relative difference in price is 2e-8. The payoff calculators stay on Deribit coin settlement.

## v3.50.0 (October 30, 2026, feature)

- **new:** Fibonacci Retracement Calculator (/fibonacci-retracement-calculator) and workflow.run_fibonacci_levels: retracement (0, 23.6, 38.2, 50, 61.8, 78.6, 100 percent) and extension (127.2, 161.8, 200, 261.8 percent) prices from a swing high and low, up or down, for any asset. The ratios are a charting convention, not a forecast; a level at or below zero comes back as null.

## v3.49.0 (October 30, 2026, feature)

- **new:** American Option Calculator (/american-option-calculator) and workflow.run_american_option: price of an American put or call on a Cox-Ross-Rubinstein binomial tree (50 to 2000 steps) with a dividend yield, early exercise checked at every node. Returns delta, gamma, theta per day, an exercise-now flag, the European Black-Scholes price beside it, the early-exercise premium and the tree error at the chosen step count. Checked against an independent Python tree, QuantLib and a 5,001-step Leisen-Reimer tree on 1,000+ random options. Tool count is now 80.

## v3.48.0 (October 30, 2026, feature)

- **new:** Black-Scholes now takes an optional continuous dividend yield (dividendYieldPct, percent per year, default 0) for stock and ETF options: price, delta, gamma, vega and theta use it, in the calculator at /black-scholes-calculator and in workflow.run_black_scholes. With 0 every result is unchanged. Checked against QuantLib on 5,000 random options with a dividend yield: the largest difference in price and Greeks is 4.4e-11. Live mode does not use the field.

## v3.47.0 (October 30, 2026, feature)

- **new:** Options Profit Calculator (/options-profit-calculator) and workflow.run_options_position: payoff at expiry in dollars for one to four option legs on a stock, ETF or index (100-share contract multiplier), with every breakeven, maximum profit and maximum loss (or unlimited), net debit or credit, and the strategy name read from the legs. Ready-made forms: vertical spreads, iron condor, iron butterfly, straddle, strangle, covered call. It calculates from the prices you enter and fetches no quotes. 1 new MCP tool.

## v3.46.0 (October 29, 2026, feature)

- **new:** Every MCP tools/call result and every /api/actions/{calc} result that is a JSON object now carries _method.release, the server release that produced it (inside the signed text for MCP); the release is also sent in the X-TradingCalc-Version header. Details: https://docs.tradingcalc.io/api

## v3.45.0 (October 28, 2026, feature)

- **new:** Barrier Touch Calculator (/barrier-touch-calculator) and workflow.run_barrier_touch: the probability that price touches a target or stop level at any time within N days, next to the probability of finishing beyond it. 1 new MCP tool, 78 tools total.
- **new:** primitive.hedge_ratio takes contractType inverse (coin-margined): the short notional stays in USD and the required margin and funding come back in the base coin. New canonical vector, 47 in total.
- **new:** workflow.run_dsr takes null_mean: centres the luck threshold on 0 instead of the mean of the supplied trial Sharpe ratios.
- **improved:** Fills and entries accept size and quantity under either name, in primitive.average_entry and workflow.run_dca_entry.

## v3.44.0 (October 27, 2026, feature)

- **improved:** Cointegration test: the critical values are now the published MacKinnon (2010) table, checked against statsmodels at sample sizes from 19 to 5000, with the size counted as coint() counts it.

## v3.43.0 (October 25, 2026, feature)

- **new:** Share links on the eight workflow pages (risk and reward, average down, DCA entry, scale out, funding breakeven, carry trade, pre-trade check, portfolio risk): a link opens the same numbers, and a field you emptied stays empty on the other side. Each result has a Copy share link button.

## v3.42.0 (October 24, 2026, feature)

- **new:** Embeddable widgets for every calculator, workflow and on-chain checker page, not only the crypto futures set. Two forms: a script that sizes the frame to its content, and a plain iframe. Theme (dark or light), accent color, background (the theme default, transparent or your own color), compact spacing and start values are configurable on the Widgets page.
- **new:** A widget guide in the docs: installation steps, every option, troubleshooting and a FAQ, at docs.tradingcalc.io/widgets.
- **improved:** Funding is now counted over the own interval of each symbol (8, 4, 2 or 1 hours). funding_cost takes a new intervalHours.
- **new:** A "Calculated by TradingCalc" badge for sites that show our results, in compact and wide shapes and three styles, as HTML, Markdown or a plain text link.

## v3.41.0 (October 23, 2026, feature)

- **improved:** Pre-trade check: the funded breakeven includes the close fee and inverse contracts. New funding_direction field (paid or received). When funding outweighs any price move, the breakeven fields are null with an explanation.
- **improved:** Pre-trade check and funding breakeven: new input funding_interval_hours (8 or 1). Hyperliquid, dYdX and Kraken settle funding every hour; naming the exchange sets the interval.
- **new:** Every canonical test vector is now also checked against an independent Python reference that solves each defining condition directly. The formula text on the methodology and verification pages and in llms.txt comes from one source and is tested against the code.

## v3.40.0 (October 22, 2026, feature)

- **new:** Swap Price Impact now works in both directions. New optional side input on the calculator, the API and workflow.run_swap_price_impact: "sell" (default, unchanged) sells a token into USDC or SOL, "buy" spends USDC or SOL to buy the token. For a buy, amount is the sum you spend and the result is the number of tokens you get; effectivePrice is the quote asset paid per token, the same unit as when selling. The calculator page has a Sell and Buy switch.

## v3.39.1 (October 22, 2026, feature)

- **improved:** API and MCP reference: the LangChain and Vercel AI SDK snippets rename tools before passing them to a model (OpenAI and Anthropic function calling do not accept the dot in a name such as workflow.run_black_scholes); the OpenAI Agents SDK snippet uses the hosted MCP tool. Each snippet was run with a real model and returned the same price as a direct call.
- **new:** API and MCP reference: a CrewAI snippet (Python 3.12 or 3.13; CrewAI itself does not support 3.14) and an Anthropic API snippet that uses the MCP connector, both run as published and returning the same price as a direct call.

## v3.39.0 (October 21, 2026, feature)

- **improved:** Number fields read plain numbers only (a dot for decimals, no thousand separators). Anything else shows a short hint and the result stays empty until the field is fixed. Whole-number fields refuse 1.5.
- **improved:** Percent fields (fees, maintenance margin, funding) follow the same rule. Inputs that used the browser number box are plain text fields now.

## v3.38.0 (October 21, 2026, feature)

- **new:** AI model benchmark (/benchmark): a monthly test of how often current language models from OpenAI, Anthropic and Google get trading math right, with their stated confidence. First run: 630 answers from 6 models on fresh questions, 97% correct, and 12 of the 17 wrong answers came with 80% confidence or more. Results by model and by task, the method in the methodology page, and every task, reference and reply as a download.
- **improved:** Navigation is grouped into Tools, Proof and Developers, with a menu on phones (there was none), and the homepage now opens with the ways to check a result: signed results, public test vectors, the daily record on Solana and the benchmark.

## v3.37.0 (October 21, 2026, feature)

- **new:** Crypto Spot, a new section for coins bought and sold outright, opens with the Crypto Profit Calculator (/crypto-profit-calculator): enter the amount invested or the coins bought, the buy and sell price and both fees to get the profit, ROI, the break-even sell price and, for a hold of 30 days or more, the annualized return. Show the math prints every step.
- **new:** workflow.run_crypto_profit (77 tools): the same calculation over MCP. Fees are a fraction of each trade value; give exactly one of investment or quantity.

## v3.36.2 (October 21, 2026, feature)

- **new:** API and MCP reference: connection snippets for LangChain, the OpenAI Agents SDK, the Vercel AI SDK and Mastra, next to the Claude Desktop and Cursor ones. Each was run against the live endpoint and listed the tools.

## v3.36.1 (October 21, 2026, feature)

- **improved:** Every parameter of every MCP tool now has a description in tools/list, including the fields inside lists such as fills, entries, exits and positions. An agent reads the format and an example before its first call.
- **improved:** initialize now answers with the protocol version the client asks for (2025-06-18, 2025-03-26 or 2024-11-05). Notifications get an empty 202, and ping is answered with an empty result.

## v3.36.0 (October 18, 2026, feature)

- **new:** Independent cross-check of the options math against QuantLib: on 5,000 random European options the Black-Scholes price and every Greek agree to within 1e-10, and the implied-volatility solver recovers the volatility from QuantLib prices to 0.0012 volatility points wherever the price depends on volatility. The window fair value of up/down prediction-market contracts (a cash-or-nothing digital option) agrees with QuantLib to 5.4e-12 percentage points on 3,000 random windows. Results and a script that repeats the Black-Scholes check against the live endpoint: docs.tradingcalc.io/methodology#quantlib-cross-check.
- **improved:** The normal distribution function behind Black-Scholes, window fair value and the Sharpe statistics is now accurate to double precision (double precision). Black-Scholes prices, deltas, thetas and rhos change slightly; gamma and vega do not.
- **new:** workflow.run_implied_volatility and the Implied Volatility calculator now return identifiable and warning. When the price barely responds to volatility (deep in the money, far out of the money, very short-dated) many volatilities reproduce it, identifiable is false and the warning says the returned value is one of them. converged keeps its meaning.

## v3.35.0 (October 2, 2026, feature)

- **new:** workflow.run_price_consensus (76 tools): checks one perpetual futures price against the same asset on a reference set of 7 liquid exchanges and reports the median, the spread and how far the chosen exchange sits from it, saying the exchanges disagree instead of guessing. The calculator pages show the same one-line check under every live price.
- **new:** /support: where to send a wrong result, a broken calculator, an MCP problem or an API key request, and what to include so it can be reproduced.
- **improved:** Every MCP tool now declares openWorldHint next to readOnlyHint and destructiveHint: true for the tools that can fetch from a third-party source while they run (exchange candles, prediction-market venues, FX rates, Deribit, on-chain data), false for the tools that only compute from the inputs given. All tools remain read-only.
- **improved:** The descriptions of Pre-Trade Check and Risk Reward, and the instructions an agent reads on connect, now say what each tool does and point to the related tool, without ranking tools against each other.

## v3.34.0 (October 1, 2026, feature)

- **new:** "Show the math", the collapsible panel under a result that substitutes your own numbers into the formula step by step, now also covers Break-even, Target Exit, Position Size, Scenario, Average Entry, Max Safe Leverage, Funding Rate Arbitrage, Hedge Ratio and Compound Funding (it was on PnL and Liquidation only), including the inverse (coin-margined) variants where they exist.

## v3.33.0 (September 30, 2026, feature)

- **new:** The MCP initialize response (what an agent reads when it connects) covers options and forex and lists domains in the order traders look for them: options, forex, risk and statistics, prediction markets, on-chain, then perpetual futures. serverInfo.version now reports the published package version (2.14.0).
- **new:** GET /api/anchors/latest: the newest finalized daily anchor (date, transaction, explorer link) for lightweight display. Full records stay at GET /api/anchors.
- **improved:** tradingcalc-mcp 2.14.0 published (MCP registry, npm, Smithery, LobeHub): title, description, instructions and README lead with options, forex, and risk/stats; the README tool table and anonymous limit (100 calls/day) now match the server. No tool was added or removed, still 75.

## v3.32.0 (September 30, 2026, feature)

- **new:** Public daily anchor: once a day the state of /verification (pass/fail, vector counts, hashes of the vector set and results) is signed with the MCP signing key and its SHA-256 is written to Solana mainnet in a Memo transaction. Records chain to each other through prevHash. Read them at GET /api/anchors; the latest record and day streak are on /verification; verification steps are in the methodology docs.

## v3.31.0 (September 29, 2026, feature)

- **new:** Every MCP tool in tools/list now carries a human-readable title (top level and in annotations.title).
- **new:** Anonymous rate limit is 100 calls/day per IP on the MCP endpoint and the REST actions endpoint; a free API key gives 200/day.

## v3.30.0 (September 27, 2026, feature)

- **new:** Cross-Venue Arbitrage Calculator (/prediction-market-arbitrage-checker, Prediction Markets domain): checks 2-5 venue quotes (or manual probabilities) for the same bet for a guaranteed, direction-independent profit, buy Yes at the cheapest venue, No at the priciest, reporting the guaranteed dollar profit and ROI for a stake, and whether a realistic per-leg trading fee erases it. 75 tools total.

## v3.29.0 (September 26, 2026, feature)

- **new:** Impermanent Loss Calculator (/impermanent-loss-calculator, On-chain domain, 6th feature): full-range (standard 50/50 AMM, the textbook 2sqrt(k)/(1+k)-1 closed form) or Uniswap-V3-style concentrated liquidity, derived from the same underlying token-amount math so the two modes are provably consistent, not two independently-derived formulas. Manual price input or a live variant that fetches both tokens' current prices (Solana or 5 EVM chains) and derives the ratio automatically. 74 tools total.

## v3.28.0 (September 26, 2026, feature)

- **new:** "Should I Average Down?" workflow (/average-down): orchestrates average_entry + liquidation + breakeven + pnl to compare adding to a losing position against the always-available alternative of buying the same final total size fresh at today's price. risk_penalty_pct is provably always positive for a genuine average-down (add price worse than the existing entry); liquidation_before_stop flags when the new liquidation price would force-close the position before its own stop-loss ever triggers. 72 tools total.

## v3.27.0 (September 26, 2026, feature)

- **new:** Vertical Spread & Iron Condor Calculator (/options-spread-calculator, Options domain): payoff, breakeven(s), and max profit/loss for a 2-leg vertical spread or 4-leg iron condor/butterfly, coin-settled for Deribit BTC/ETH. Two findings that don't match USD-settled textbook results: a debit vertical spread's max profit peaks exactly at one strike then decays back toward a full loss of the premium (two breakevens, not a permanent zone), and an iron condor's put-side max loss is genuinely unbounded toward zero, unlike its call side. 71 tools total.

## v3.26.0 (September 25, 2026, feature)

- **new:** New page: /about, the story behind TradingCalc and why it exists as a free, deterministic computation layer rather than a paid SaaS.

## v3.25.0 (September 25, 2026, feature)

- **new:** Order-Book Impact Calculator (/orderbook-impact-calculator): "walk the book" VWAP/price-impact for a target notional, or the max notional that stays within an impact budget, solved via bisection. 70 tools total.
- **new:** PnL Calculator gained a maxLossBound field for inverse+short positions: the coin-denominated loss ceiling as exit price rises without limit - the opening fee survives the limit while the closing fee vanishes.

## v3.24.0 (September 25, 2026, feature)

- **new:** Return Unsmoothing Calculator (/return-unsmoothing-calculator): Getmansky-Lo-Makarov MA(2) smoothing index plus Blundell-Ward AR(1) volatility inflation, for infrequently-marked/appraisal-based return series that understate true volatility.
- **new:** EVT Tail Risk Calculator (/evt-tail-risk-calculator): Peaks-Over-Threshold Extreme Value Theory - fits a Generalized Pareto Distribution to the loss tail via Grimshaw's profile-likelihood MLE, extrapolates VaR/Expected Shortfall without assuming a normal distribution. Both cross-checked against Python reference implementations (statsmodels, scipy.stats.genpareto). 69 tools total.

## v3.23.0 (September 25, 2026, feature)

- **new:** Kelly Growth-Security Frontier Calculator (/kelly-growth-security-frontier-calculator): MacLean-Ziemba-Blazenko fractional-Kelly frontier - the probability a strategy compounding at a fraction of full Kelly ever loses a given fraction of its starting capital, or the fraction that keeps that risk under a target. 67 tools total.

## v3.22.0 (September 25, 2026, feature)

- **new:** "Show the Math" worked-example panel, live on PnL and Liquidation: substitutes the visitor's own actual input numbers into the formula so a result can be hand-verified in the time it takes to reach for a phone calculator, rather than trusting the number outright.

## v3.21.0 (September 25, 2026, feature)

- **new:** Homepage trust section surfaces the ECDSA P-256 signed-response mechanism: an MCP tool result can be verified offline against a published key.
- **new:** Deflated Sharpe Ratio Calculator (/deflated-sharpe-ratio-calculator): the Sharpe threshold the best of N tried strategy variants would clear by luck alone, corrected for correlated trials, reusing the existing Sharpe/PSR machinery.
- **new:** VaR/CVaR Calculator gained Modified (Cornish-Fisher) VaR: a skew/kurtosis-aware quantile correction, re-derived and cross-checked directly against the textbook lower-tail form rather than assumed equivalent under this project's positive-z convention.
- **new:** Portfolio Tearsheet gained the drawdown-ratio cluster: Ulcer Index/Martin ratio, Pain/Pain ratio, Burke ratio (and its modified variant), Omega-Sharpe, Upside Potential Ratio, Pezier-White Adjusted Sharpe. 66 tools total.

## v3.20.0 (September 25, 2026, feature)

- **new:** Risk/Stats v2: GARCH(1,1) Volatility Calculator (/garch-volatility-calculator) and Risk Parity Calculator (/risk-parity-calculator, long-only weights for 2-6 assets). Cross-checked against the Python arch package, the exact two-asset closed form and scipy.optimize. 2 new MCP tools (workflow.run_garch, _risk_parity), 65 tools total.

## v3.19.0 (September 25, 2026, feature)

- **new:** New domain: Risk/Stats, the 6th top-level domain. 5 calculators: VaR / CVaR (/var-cvar-calculator, parametric Value at Risk and Conditional VaR / Expected Shortfall), Sharpe Ratio (/sharpe-ratio-calculator, the Lo 2002 serial-correlation-aware annualization correction plus the Probabilistic Sharpe Ratio), Hurst Exponent (/hurst-exponent-calculator, rescaled-range R/S analysis), Cointegration Test (/cointegration-calculator, Engle-Granger two-step pairs-trading test), and Portfolio Tearsheet (/portfolio-tearsheet-calculator, annualized return/volatility, Sharpe, Sortino, max drawdown, Calmar, skew/kurtosis, PSR, win rate in one call). 5 new MCP tools (workflow.run_var_cvar, _sharpe_stats, _hurst_exponent, _cointegration, _portfolio_tearsheet), 63 tools total. Manual return-series input, no live-data dependency, same precedent as Forex Phase 1.
- **new:** Every formula was verified against Python reference libraries (numpy, scipy, statsmodels, arch), not only against the TypeScript code. Cointegration critical values are a response-surface fit to statsmodels output, documented as such.

## v3.18.0 (September 24, 2026, feature)

- **new:** Market Structure web pages shipped: Open Analysis (/open-analysis), Session Structure (/session-structure), Value Migration (/value-migration), Breakout Acceptance (/breakout-acceptance). The compute layer and all 4 MCP tools (workflow.run_open_analysis, _session_structure, _value_migration, _breakout_acceptance) have been live since 2026-09-17/18; these pages are the first way a human visitor can reach them. Binance and Bybit only (the two adapters with a live candle-fetch endpoint).
- **new:** New API route /api/market/market-structure/[tool] backing these pages: platform-fetches live candles and runs the same compute functions the MCP tools call.
- **new:** New nav section (Market Structure) in the sidebar, a new /tools listing band, and the /workflows hub's Market Structure family switched from COMING SOON placeholders to live links.

## v3.17.0 (September 24, 2026, feature)

- **new:** 5 new Forex pages for Phase 2/3's account-currency and correlation tools: Margin Required (/forex-margin-required-calculator), Currency Converter (/forex-currency-converter), Position Size (/forex-position-size-calculator), Swap/Rollover (/forex-swap-calculator), Correlation (/forex-correlation-calculator). Pip Value's existing page gained a live account-currency conversion section.
- **new:** Two new live-data API routes backing these pages: /api/market/fx-rate and /api/market/fx-correlation.

## v3.16.0 (September 24, 2026, feature)

- **new:** Prediction Markets expanded from 3 to 5 venues: Limitless (on-chain, Base, mostly short-duration 5-min/15-min/daily crypto up/down contracts) and Myriad (on-chain, Abstract L2, general prediction markets with a dedicated Crypto topic) added alongside Kalshi, Polymarket, and ADI Predictstreet.
- **new:** Odds/Probability Converter (/odds-probability-converter) and Prediction Market Spread Checker (/prediction-market-spread-checker, now 2-5 venues) read both new venues live. Prediction Market Edge Sizer (Kelly Calculator) gained live Limitless/Myriad sources at the MCP layer alongside its existing Kalshi one.
- **new:** 19 new tests, 558 tests total.

## v3.15.0 (September 24, 2026, feature)

- **new:** Forex Phase 3 (swap/rollover cost, correlation/hedge ratio) shipped at the lib/MCP layer. Correlation and minimum-variance hedge ratio computed on daily % returns from frankfurter.app's historical rate time series. Swap/rollover cost takes the swap rate as a manual input (broker-set, no live feed exists). 4 new MCP tools (workflow.run_forex_swap_cost, _swap_cost_live, _correlation, _correlation_live), 58 tools total. 539 tests total. Standalone web pages for these are not part of this release.

## v3.14.0 (September 24, 2026, feature)

- **new:** Forex Phase 2 (account-currency conversion) shipped at the lib/MCP layer: live FX rate source (TrueFX for its 10 major pairs, frankfurter.app daily rate as the fallback for every other currency). 2 new calculators (Margin Required, Currency Converter) plus account-currency conversion added to Pip Value. 6 new MCP tools (workflow.run_forex_margin_required, _currency_converter, _pip_value_live, _margin_required_live, _position_size_live, _currency_converter_live), 54 tools total. 523 tests total. Standalone web pages for these are not part of this release.

## v3.13.0 (September 24, 2026, feature)

- **improved:** Every forex calculator's Currency Pair field is now a dropdown of the 10 most common pairs (EUR/USD, USD/JPY, GBP/USD, and 7 others), not a bare text input. Any valid BASE/QUOTE pair can still be typed directly. Applied to all 6 widgets with a pair field (PnL, Pip Value, Breakeven, Risk/Reward, Scenario, Average Entry); Margin Level has none, it's account-level math.

## v3.12.0 (September 24, 2026, feature)

- **new:** New workflow: Portfolio Risk (/portfolio-risk): aggregates P&L, margin usage, and liquidation distance across multiple open positions. Linear (USDT-margined) positions sum in USD; inverse (coin-margined) positions group by settlement coin. Returns a verdict: healthy / watch / reduce / critical. 1 new MCP tool (workflow.run_portfolio_risk), 48 tools total. 497 tests total.

## v3.11.0 (September 24, 2026, feature)

- **improved:** Clearer validation-error messages from the MCP server and the REST calculator API.
- **new:** Tails & Single Prints (rejection wicks and one-touch price levels at the session extreme) added to the response of workflow.run_open_analysis, workflow.run_session_structure, and workflow.run_value_migration.

## v3.10.0 (September 23, 2026, feature)

- **new:** Polymarket Perps added as a 17th exchange (17 exchanges / 203 pages). USD-margined perpetual futures, keyless REST, spanning crypto, single stocks, indices and commodities.

## v3.9.0 (September 21, 2026, feature)

- **new:** Forex added as a 5th top-level domain: 7 calculators, all quote-currency denominated. Pip Value (/forex-pip-value-calculator), Margin Level (/forex-margin-level-calculator), Breakeven (/forex-breakeven-calculator), PnL (/forex-pnl-calculator), Risk/Reward (/forex-risk-reward-calculator), Scenario (/forex-scenario-calculator), Average Entry (/forex-average-entry-calculator).
- **new:** 7 new MCP tools (workflow.run_forex_pip_value, _margin_level, _breakeven, _pnl, _risk_reward, _scenario, _average_entry), 47 tools total across 9 suites. 441 tests total.

## v3.8.0 (September 21, 2026, feature)

- **new:** Odds/Probability Converter (/odds-probability-converter) now reads two more live venues alongside Kalshi: Polymarket and ADI Predictstreet.
- **new:** Prediction Market Spread Checker (/prediction-market-spread-checker): compares a bet's live price across 2-4 venues (Kalshi, Polymarket, ADI Predictstreet) and reports the spread.
- **new:** 2 new MCP tools, 40 tools total. 399 tests total.

## v3.7.0 (September 20, 2026, feature)

- **new:** Crypto Up/Down Fair Value Calculator (/crypto-updown-fair-value-calculator): theoretical fair value for time-windowed crypto up/down contracts (ADI Predictstreet, Polymarket, Kalshi-style dailies), priced as a cash-or-nothing digital option. 1 new MCP tool (workflow.run_window_fair_value, 39 tools total); 395 tests total.

## v3.6.0 (September 20, 2026, feature)

- **new:** Implied Volatility Calculator (/implied-volatility-calculator): solves for the volatility Black-Scholes needs to reproduce an observed option price. 1 new MCP tool (workflow.run_implied_volatility, 38 tools total); 390 tests total.

## v3.5.0 (September 20, 2026, feature)

- **new:** Straddle & Strangle Calculator (/straddle-strangle-calculator): two-leg call+put combination P&L, breakevens, max loss/profit. Covered Call & Protective Put Calculator (/covered-call-calculator): coin held plus one option leg, annualized yield or insurance cost. 2 new MCP tools (37 tools total); 383 tests total.

## v3.4.0 (September 20, 2026, feature)

- **new:** New domain: Options, for Deribit BTC/ETH options (coin-settled). Options Payoff & Breakeven Calculator (/options-payoff-calculator): single-leg long/short call/put P&L, breakeven, max loss/profit. Black-Scholes Calculator (/black-scholes-calculator): theoretical price and Greeks, manual or live from a real Deribit instrument. Both also available as MCP tools (35 tools total).

## v3.3.0 (September 19, 2026, feature)

- **new:** Signed tool responses: every MCP tools/call result now carries a second content block with an ECDSA P-256 signature over the result, so agents can verify offline that a response came from tradingcalc.io unaltered. New tool system.pubkey (also GET /api/mcp/pubkey) returns the public key and canonical string format (32 tools total).

## v3.2.0 (September 17, 2026, feature)

- **new:** New domain: Prediction Markets, reading Kalshi's public crypto-price markets. Odds Converter (/odds-probability-converter), Market-Implied Odds (/market-implied-odds), Edge Sizer (/prediction-market-edge). All three also available as MCP tools (31 tools total).

## v3.1.0 (September 17, 2026, feature)

- **new:** Market Cap Comparison and Wallet Flag Check are now chain-agnostic: Solana plus 5 EVM chains (Ethereum, Base, BSC, Arbitrum, Polygon), and the two tokens in a market-cap comparison can be on different chains.
- **new:** ScamSniffer added as a third wallet-flag source on EVM chains.

## v3.0.0 (September 17, 2026, feature)

- **new:** New tool: Wallet Flag Check (/wallet-flag-check): checks a Solana wallet against GoPlus (18 malicious-address categories, keyless) and Webacy (address analysis + sanctions check, keyed). Also available as an MCP tool, workflow.run_wallet_flag_check (28 tools total).

## v2.9.0 (September 17, 2026, feature)

- **new:** New calculator: Market Cap Comparison (/market-cap-comparison): projects what an investment would be worth if a token's market cap matched a second token's. Also available as an MCP tool, workflow.run_market_cap_comparison (27 tools total).

## v2.8.0 (September 17, 2026, feature)

- **new:** New calculator: Bonding Curve (/bonding-curve-calculator): exact tokens received, price impact, and graduation progress for a pump.fun-style bonding curve buy. Also available as an MCP tool, workflow.run_bonding_curve (26 tools total).

## v2.7.0 (September 16, 2026, feature)

- **new:** New calculator: Swap Price Impact (/swap-price-impact-calculator): live-routed price-impact quote for a Solana swap via Jupiter. Also available as an MCP tool, workflow.run_swap_price_impact (25 tools total). First entry in a new "On-chain" nav section alongside the Rug Pull Checker.

## v2.6.0 (September 16, 2026, feature)

- **new:** New workflow: Rug Pull Checker (/rug-pull-checker): Solana token safety spot-check, scoring rug mechanisms (mint/freeze authority, LP-lock %, mutable metadata, named scam-pattern flags from RugCheck/GoPlus). Holder concentration and top-holder dump-impact shown separately as informational context. Also available as an MCP tool, workflow.run_token_risk_check (24 tools total).

## v2.5.1 (September 16, 2026, feature)

- **improved:** CoinEx removed from the exchange matrix (16 exchanges / 192 pages).

## v2.5.0 (September 8, 2026, feature)

- **new:** Inverse (coin-margined) contract support added to 8 calculators (pnl, liquidation, average_entry, breakeven, target_exit, scenario, risk_sizer, funding_cost) via a new contractType: "linear" | "inverse" field, default "linear".
- **new:** 12 of 17 exchange adapters now expose real coin-margined markets (Bybit, OKX, KuCoin, Kraken, Blofin, CoinEx, Binance COIN-M, Gate, HTX, Phemex, Deribit, MEXC) with an "INVERSE" badge in the instrument picker.

## v2.4.0 (September 6, 2026, feature)

- **new:** dYdX v4 added to the exchange matrix: 17 exchanges / 203 pages total.
- **new:** Shareable result links + embeddable <iframe> widgets extended from 3 to all 12 standalone calculators.

## v2.3.0 (September 5, 2026, feature)

- **new:** Exchange x calculator matrix grows to 191 pages: 9 new exchanges added (Gate.io, Deribit, Kraken, HTX, WOO X, Phemex, Blofin, Backpack, CoinEx) with real fees/leverage and live-data adapters.
- **new:** HowTo JSON-LD added across all 191 matrix pages plus all 12 standalone calculators, alongside the existing SoftwareApplication/FAQPage/BreadcrumbList schema.
- **new:** Sitewide Organization JSON-LD added to the root layout.
- **new:** Shareable result links on Position Size, Liquidation, and PnL calculators.
- **new:** Embeddable <iframe> widgets for Position Size, Liquidation, and PnL.

## v2.2.0 (April 9, 2026, feature)

- **new:** /what-is-deterministic-computation-layer: concept page with 4 properties (idempotent / traceable / verifiable / composable), contrast table vs LLM / spreadsheet, use-case matrix.
- **new:** /deterministic-workflows: product hub with Primitive → Analyzer → Workflow taxonomy, all 6 workflows with primitives and verdicts, REST API example.
- **new:** Internal /pre-trade-check links added to 5 calculator pages: pnl, breakeven, target-exit, scenario, max-safe-leverage.

## v2.1.0 (April 9, 2026, feature)

- **new:** /methodology: formula derivation reference covering all 12 calculators, exchange doc sources, 3-layer verification system, test vector example.
- **new:** /why-ai-agents-need-exact-calculations: mid-funnel SEO article covering LLM vs deterministic tool, architecture pattern, critical calculation types.
- **new:** 55 exchange-specific calculator pages indexed in sitemap (binance/bybit/okx/hyperliquid/aster/kucoin/mexc × 7–8 calculators).

## v2.0.1 (April 9, 2026, feature)

- **new:** examples/risk-agent-wrapper.ts: drop-in TypeScript risk gate for agent frameworks (ElizaOS, CrewAI, AutoGen, Hummingbot, Freqtrade).
- **new:** RiskAgent class: evaluate() returns full check result, isSafe() returns binary go/no-go; preTradeGate() standalone function; configurable gates: rejectUnsafe, rejectHighRisk, minLiqDistancePct.

## v2.0.0 (April 8, 2026, feature)

- **new:** tradingcalc-sdk@2.0.0: namespace API with client.workflows.* / client.primitives.* / client.system.*.
- **new:** PrimitivesNamespace, WorkflowsNamespace, SystemNamespace exported as first-class types.
- **break:** Flat methods removed (tc.pnl, tc.verify, etc.). Migrate to tc.workflows.pnl(), tc.system.verify(). tc.call() unchanged.

## v1.7.0 (April 8, 2026, feature)

- **new:** /playground: interactive calculator hub, 12 calculators in 3-suite grid (Trade Planning / Risk & Margin / Funding & Carry).
- **new:** /verification: canonical verification hub with live test vectors, formula assumptions, error model, version history.

## v1.6.0 (April 7, 2026, feature)

- **new:** /workflows hub, top-level product catalog with 4 workflow families: Integrated Decisions, Planning, Funding & Carry, Market Structure (coming soon).
- **new:** Nav updated across all calc pages: "Workflows" link added, "All calculators" → "Calculators".
- **new:** tradingcalc-sdk@1.5.2 published to npm: typed TypeScript client with all 13 tools, TradingCalcClient, TradingCalcError.
- **new:** /for-agents: SDK quickstart section, request+response examples for pnl / positionSize / preTradeCheck.
- **new:** CHANGELOG.md published to public tradingcalc-mcp repo.

## v1.5.2 (April 7, 2026, feature)

- **new:** All workflow pages open with live pre-filled example: result visible before first keystroke.
- **new:** Risk/Reward: counterfactual nudge, "Move target to $X → 2:1. Win rate drops from Y% to Z%".
- **new:** Risk/Reward: partial results after 3 fields, verdict and price ladder appear without account size.
- **new:** Direct personal language across all widgets: "You're risking $100 to make $240. If your stop hits..."
- **new:** Narrative bars rewritten: "You're going long BTC/USDT at $83,000 · your stop is $80,500".
- **new:** Empty states rewritten as questions: "Where are you buying? I'll tell you your real entry price."
- **new:** Page descriptions rewritten with trader insight hooks, not feature lists.

## v1.5.1 (April 7, 2026, feature)

- **new:** All 6 workflow pages rewritten with human-narrative UX: question titles, conversational labels, narrative preview bar, verdict cards.
- **new:** Instrument selector on all workflow pages: exchange + live pair list + "Use current price" button.
- **new:** Risk/Reward: visual price ladder (stop/entry/target proportions), minimum win rate metric.
- **new:** Funding Breakeven: live funding rate auto-fill from selected exchange/pair.
- **new:** Carry Trade: live funding rates for both legs with independent exchange selectors.
- **new:** Scale-Out: visual exit ladder showing exit points proportional to price range.
- **new:** Cross-workflow navigation links: Risk/Reward → Scale-Out, DCA Entry → Funding Breakeven, etc.
- **new:** /terms and /changelog pages added; proper footer on all standalone pages.

## v1.5.0 (April 6, 2026, major)

- **new:** Added 5 composite workflows: Risk/Reward, Carry Trade Setup, DCA Entry, Scale-Out Planner, Funding Breakeven.
- **new:** Web pages for all 6 workflows: live interactive calculators with FAQ and structured data.
- **new:** Credits-based billing system: 5 plan tiers from Free to Growth ($599/mo).
- **new:** REST API: /v1/primitives and /v1/workflows with Bearer authentication and per-plan rate limits.
- **new:** MCP server v1.5: workflow.run_* / primitive.* / system.* namespace, backward compat with flat names.

## v1.4.0 (March 30, 2026, feature)

- **new:** Pre-Trade Check workflow: position size, liquidation, breakeven, funding cost, safety classification in one call.
- **new:** Public verification page at /verify: runs 22 canonical test vectors live on every request.
- **new:** MCP tool system.verify: agents can self-verify all calculators before trusting results.
- **new:** /for-agents developer page with MCP quickstart for Claude Desktop, Cursor, and VS Code.
- **new:** Funding Arbitrage calculator: annualized yield across two exchanges.
- **new:** Hedge Ratio calculator: short perp size and funding cost to hedge a spot position.

## v1.3.0 (March 15, 2026, feature)

- **new:** Compound Funding calculator: capital growth projection from reinvesting funding income.
- **new:** Max Safe Leverage calculator: maximum leverage from drawdown tolerance and volatility.
- **new:** Scenario Analysis: multi-scenario P&L table across a price range.
- **new:** Exchange adapter system: normalized formulas across Binance, Bybit, OKX, Hyperliquid, Aster, KuCoin, MEXC.

## v1.2.0 (February 28, 2026, feature)

- **new:** Position Sizer: size from account balance and max risk %.
- **new:** Average Entry: weighted average across multiple DCA fills.
- **new:** Target Exit: exit price required to hit a target PnL or ROE.
- **new:** Telegram Mini App: 8 languages, auto-detected from Telegram profile.
- **new:** Live price feed via exchange APIs: auto-fills entry price in calculators.

## v1.1.0 (February 10, 2026, feature)

- **new:** Funding Cost calculator: cumulative funding over a holding period.
- **new:** Break-even Price calculator: accounts for entry and exit fees.
- **new:** Web calculator pages with SEO metadata and FAQ structured data.

## v1.0.0 (January 20, 2026, launch)

- **new:** Initial release: PnL and Liquidation Price calculators.
- **new:** Binance and Bybit exchange support.
- **new:** Telegram bot @perpcalcbot.
