Changelog
New tools, API changes, and formula updates.
v3.2.0featureSeptember 17, 2026
- newNew domain: Prediction Markets — three tools reading Kalshi's public crypto-price markets (a CFTC-regulated exchange, keyless market-data API, settlement sourced to CF Benchmarks' BRTI index). Odds Converter (/odds-probability-converter) converts a probability — manual or live — into decimal/American odds and breakeven win rate, surfacing the vig only when a live market gives both sides of the price. Market-Implied Odds (/market-implied-odds) reads the full BTC/ETH year-end price ladder and reports median/mode bucket and probability at any real bucket boundary — deliberately no expected value or in-bucket interpolation, since the open-ended top/bottom buckets would need an invented assumption. Edge Sizer (/prediction-market-edge) compares your own probability estimate against a market's price and sizes a bet with fractional (quarter-)Kelly. Scoped to Kalshi's Crypto category only, not politics/sports (stays horizontal within crypto); Polymarket was evaluated and found unreachable from this network entirely. Third top-level domain alongside Calculators/Workflows and On-chain, with its own registry from day one. All three also available as MCP tools (31 tools total).
v3.1.0featureSeptember 17, 2026
- newMarket 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. The On-chain domain had defaulted to Solana-only by inertia from the first feature's narrative-driven scope, not a deliberate decision — caught when ScamSniffer was rejected as a wallet-risk source for being "EVM-only," which is a real limitation only because of that unexamined default. Both keyed vendors (GoPlus, Webacy) already supported other chains via the same API, so this cost only wiring, not new integrations.
- newScamSniffer added as a third wallet-flag source on EVM chains — their hosted lookup API needs a real paid key (the documented "demo-api-key" doesn't work), but their GitHub-hosted public blacklist (2530 addresses, refreshed hourly) is keyless and openly licensed for exactly this use.
v3.0.0featureSeptember 17, 2026
- newNew tool: Wallet Flag Check (/wallet-flag-check) — checks a Solana wallet against two independent sources (GoPlus's 18 malicious-address categories, keyless; Webacy's address analysis + dedicated sanctions check, keyed) and shows each source's own facts separately, never merged into one invented score. First feature to require a paid-signup vendor (WEBACY_API_KEY) — every prior on-chain tool was fully keyless. Vendor research also ruled out ScamSniffer (public database is EVM-only, zero Solana addresses out of 2530 entries) and confirmed RugCheck's documented wallet-risk endpoint is dead (404). Also available as an MCP tool, workflow.run_wallet_flag_check (28 tools total)
v2.9.0featureSeptember 17, 2026
- newNew 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, right now. Deliberately narrative-agnostic (works for any token pair, not one hype cycle). Extracted the DexScreener pair-lookup fetch (previously duplicated independently in the rug-checker and swap-impact calculator — third copy) into a shared src/lib/onchain/dexscreener.ts. Fourth On-chain tool, first one needing two independent live identifier lookups instead of one. Also available as an MCP tool, workflow.run_market_cap_comparison (27 tools total)
v2.8.0featureSeptember 17, 2026
- newNew calculator: Bonding Curve (/bonding-curve-calculator) — exact tokens received, price impact, and graduation progress for a pump.fun-style bonding curve buy. Pure constant-product (Uniswap V2) math using pump.fun's official virtual-reserve constants (sourced from github.com/pump-fun/pump-public-docs, not a blog estimate) — no live lookup needed. Graduation threshold (~85 SOL raised) is derived from the reserve constants, not hardcoded. Handles the boundary case where a buy would overshoot graduation: the curve only has finite real tokens to sell, so the excess SOL is surfaced as unspent, not silently absorbed. Third On-chain tool, also available as an MCP tool, workflow.run_bonding_curve (26 tools total)
v2.7.0featureSeptember 16, 2026
- newNew calculator: Swap Price Impact (/swap-price-impact-calculator) — live-routed price-impact quote for a Solana swap via Jupiter, across every pool it knows about, not a single-pool estimate. Shows what you'll actually receive vs current market price. Also available as an MCP tool, workflow.run_swap_price_impact (25 tools total). First member of a new "On-chain" nav section alongside the Rug Pull Checker
v2.6.0featureSeptember 16, 2026
- newNew workflow: Rug Pull Checker (/rug-pull-checker) — Solana token safety spot-check. Scores only rug MECHANISMS: mint/freeze authority, LP-lock %, mutable metadata, and named scam-pattern flags from RugCheck (GoPlus as fallback). Holder concentration and top-holder dump-impact are shown separately as informational market context, never scored — an earlier version scored them and it broke immediately on live testing (large legitimate tokens landed in the worst band purely for being liquid). Facts that can't be verified during a RugCheck outage come back as null, never a guessed 0/false. Also available as an MCP tool, workflow.run_token_risk_check (24 tools total)
v2.5.1fixSeptember 16, 2026
- fixCoinEx removed from the exchange matrix after its official shutdown announcement (spot trading stops September 29, 2026; withdrawals close December 22). Adapter, instrument picker entry, and matrix page removed same-day — 17 exchanges / 203 pages is now 16 exchanges / 192 pages
- fixFundingRateWidget ignored contractType entirely: an inverse market (e.g. Bybit BTC/USD) silently ran the linear funding-cost formula and mislabeled the result USDT instead of the base coin. Fixed and verified live against both a linear and an inverse Bybit market
v2.5.0featureSeptember 8, 2026
- newInverse (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". Formulas verified against Bybit's documented inverse liquidation formula and by algebraic round-trip checks, not just derived from scratch
- new12 of 17 exchange adapters now expose real coin-margined markets (Bybit, OKX, KuCoin, Kraken, Blofin, CoinEx, Binance COIN-M, Gate BTC-settled, HTX coin-margined swaps, Phemex classic inverse, Deribit BTC/ETH-PERPETUAL, MEXC) with an "INVERSE" badge in the instrument picker; the other 5 (Aster, Hyperliquid, WOO X, Backpack, dYdX) have no coin-margined product line to add
- fixaverage_entry was silently wrong for coin-margined fills: it averaged prices arithmetically instead of by the harmonic mean, e.g. two equal-size fills at $2,000 and $4,000 came back as $3,000 instead of the correct $2,666.67 — root cause of this whole release
- fixDeribit's BTC-PERPETUAL / ETH-PERPETUAL (natively inverse — Deribit has no linear version of these) and MEXC's coin-margined *_USD contracts were reaching the calculators unfiltered and unlabeled, producing linear-math results for genuinely inverse instruments
- fixPhemex's classic inverse line was serving 26 delisted "u"-prefixed contracts as if tradeable, and its case-sensitive quanto symbols (cETHUSD etc.) 500'd through /api/quote because that route uppercases symbols — fixed with a case-insensitive product lookup inside the adapter rather than changing the shared route
v2.4.0featureSeptember 6, 2026
- newdYdX v4 added to the exchange matrix — 17 exchanges / 203 pages total. Vertex Protocol evaluated and rejected: its old DEX/backend was fully sunset in 2025 after an acquisition by Ink Foundation, not just hard to find docs for
- newShareable result links + embeddable <iframe> widgets extended from 3 to all 12 standalone calculators
- fixHomepage stats tile and several marketing pages (for-agents, mcp, tools, workflows) still said "7 exchanges" after the matrix grew past 17 — audited every numeric claim (exchange/calculator/workflow/tool counts) across those pages instead of fixing just the one tile that was reported. Also caught a stale "22 deterministic crypto risk tools" on /tools (should be 23)
- fixLandingPage exchange strip now includes all 17 exchanges (was still listing only the original 7); the 10 new entries use plain official-site links, not affiliate links — an `affiliate` flag controls the rel="sponsored" attribute per-link so it stays accurate
v2.3.0featureSeptember 5, 2026
- newExchange x calculator matrix grows from 55 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, on top of the existing 4 composite calculators (max-safe-leverage, hedge-ratio, funding-arb, compound-funding) already wired into the matrix
- newHowTo JSON-LD added across all 191 matrix pages plus all 12 standalone calculators, alongside the existing SoftwareApplication/FAQPage/BreadcrumbList schema
- newSitewide Organization JSON-LD added to the root layout
- newShareable result links on Position Size, Liquidation, and PnL calculators — inputs sync to the URL as you type, with a "Copy share link" button once a result is shown
- newEmbeddable <iframe> widgets for Position Size, Liquidation, and PnL, with a "Copy embed code" snippet on each calculator page
- fixllms.txt rewritten: was advertising 13 calculators / 7 exchanges / a retired Telegram bot; now lists the current 12 calculators, 23 MCP tools, 16 exchanges, and canonical formulas
- fixRoot layout metadata ("Crypto Calc TWA / Telegram mini app calculators") was a leftover from before the July 2026 pivot — replaced with the current site title/description
v2.2.0featureApril 9, 2026
- new/what-is-deterministic-computation-layer: concept page with 4 properties (idempotent / traceable / verifiable / composable), contrast table vs LLM / spreadsheet, use-case matrix, pure-function code example
- new/deterministic-workflows: product hub with Primitive → Analyzer → Workflow taxonomy, all 6 workflows with primitives and verdicts, REST API example, cross-links to concept pages
- newInternal /pre-trade-check links added to 5 calculator pages missing them: pnl, breakeven, target-exit, scenario, max-safe-leverage
- fixPlayground link unified to /crypto-pnl-calculator across all 4 surfaces (WebCalcLayout header + footer, SiteHeader, SiteFooter). Previously WebCalcLayout pointed to /tools, causing alternating navigation between pages
- fix/docs sidebar: Concepts section added with links to computation layer, workflows, methodology
- fix/docs footer: expanded to 4-column grid, added Concepts card linking to new pages
- fix/for-agents "Why deterministic" section: added links to /what-is-deterministic-computation-layer and /deterministic-workflows alongside existing /why-ai-agents-need-exact-calculations
v2.1.0featureApril 9, 2026
- 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
- new55 exchange-specific calculator pages indexed in sitemap (binance/bybit/okx/hyperliquid/aster/kucoin/mexc × 7–8 calculators)
- fixSiteFooter: Methodology link added, discoverable from all dark-theme pages
- fix/for-agents: contextual links to /methodology and /why-ai-agents-need-exact-calculations
v2.0.1fixApril 9, 2026
- fixtradingcalc-sdk@2.0.1: PreTradeCheckOutput missing verdict / verdict_summary fields in dist types (were present in source but not in 2.0.0 build)
- newexamples/risk-agent-wrapper.ts: drop-in TypeScript risk gate for agent frameworks (ElizaOS, CrewAI, AutoGen, Hummingbot, Freqtrade)
- newRiskAgent class: evaluate() returns full check result, isSafe() returns binary go/no-go; preTradeGate() standalone function; configurable gates: rejectUnsafe, rejectHighRisk, minLiqDistancePct
v2.0.0featureApril 8, 2026
- newtradingcalc-sdk@2.0.0: namespace API with client.workflows.* / client.primitives.* / client.system.*
- newPrimitivesNamespace, WorkflowsNamespace, SystemNamespace exported as first-class types
- breakFlat methods removed (tc.pnl, tc.verify, etc.). Migrate to tc.workflows.pnl(), tc.system.verify(). tc.call() unchanged.
v1.7.0featureApril 8, 2026
- 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
- fix/verify redirects to /verification: backward-compatible, all old links preserved
- fixSiteHeader nav: Playground → /playground, Verification added, Docs → /docs
v1.6.0featureApril 7, 2026
- new/workflows hub, top-level product catalog with 4 workflow families: Integrated Decisions, Planning, Funding & Carry, Market Structure (coming soon)
- newNav updated across all calc pages: "Workflows" link added, "All calculators" → "Calculators"
- newtradingcalc-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
- newCHANGELOG.md published to public tradingcalc-mcp repo
v1.5.2featureApril 7, 2026
- newAll workflow pages open with live pre-filled example: result visible before first keystroke
- newRisk/Reward: counterfactual nudge, "Move target to $X → 2:1. Win rate drops from Y% to Z%"
- newRisk/Reward: partial results after 3 fields, verdict and price ladder appear without account size
- newDirect personal language across all widgets: "You're risking $100 to make $240. If your stop hits..."
- newNarrative bars rewritten: "You're going long BTC/USDT at $83,000 · your stop is $80,500"
- newEmpty states rewritten as questions: "Where are you buying? I'll tell you your real entry price."
- newPage descriptions rewritten with trader insight hooks, not feature lists
v1.5.1featureApril 7, 2026
- newAll 6 workflow pages rewritten with human-narrative UX: question titles, conversational labels, narrative preview bar, verdict cards
- newInstrument selector on all workflow pages: exchange + live pair list + "Use current price" button
- newRisk/Reward: visual price ladder (stop/entry/target proportions), minimum win rate metric
- newFunding Breakeven: live funding rate auto-fill from selected exchange/pair
- newCarry Trade: live funding rates for both legs with independent exchange selectors
- newScale-Out: visual exit ladder showing exit points proportional to price range
- newCross-workflow navigation links: Risk/Reward → Scale-Out, DCA Entry → Funding Breakeven, etc.
- fix/verify and /for-agents: removed captureServerEvent RSC call that caused 500 errors
- new/terms and /changelog pages added; proper footer on all standalone pages
v1.5.0majorApril 6, 2026
- newAdded 5 composite workflows: Risk/Reward, Carry Trade Setup, DCA Entry, Scale-Out Planner, Funding Breakeven
- newWeb pages for all 6 workflows: live interactive calculators with FAQ and structured data
- newCredits-based billing system: 5 plan tiers from Free to Growth ($599/mo)
- newREST API: /v1/primitives and /v1/workflows with Bearer authentication and per-plan rate limits
- newMCP server v1.5: workflow.run_* / primitive.* / system.* namespace, backward compat with flat names
- fixRate limits enforced uniformly across all plans including Growth (2M req/day)
v1.4.0featureMarch 30, 2026
- newPre-Trade Check workflow: position size, liquidation, breakeven, funding cost, safety classification in one call
- newPublic verification page at /verify: runs 22 canonical test vectors live on every request
- newMCP 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
- newFunding Arbitrage calculator: annualized yield across two exchanges
- newHedge Ratio calculator: short perp size and funding cost to hedge a spot position
v1.3.0featureMarch 15, 2026
- newCompound Funding calculator: capital growth projection from reinvesting funding income
- newMax Safe Leverage calculator: maximum leverage from drawdown tolerance and volatility
- newScenario Analysis: multi-scenario P&L table across a price range
- newExchange adapter system: normalized formulas across Binance, Bybit, OKX, Hyperliquid, Aster, KuCoin, MEXC
- fixFunding cost calculation aligned with Hyperliquid 1-hour funding interval
v1.2.0featureFebruary 28, 2026
- newPosition Sizer: size from account balance and max risk %
- newAverage Entry: weighted average across multiple DCA fills
- newTarget Exit: exit price required to hit a target PnL or ROE
- newTelegram Mini App: 8 languages, auto-detected from Telegram profile
- newLive price feed via exchange APIs: auto-fills entry price in calculators
v1.1.0featureFebruary 10, 2026
- newFunding Cost calculator: cumulative funding over a holding period
- newBreak-even Price calculator: accounts for entry and exit fees
- newWeb calculator pages with SEO metadata and FAQ structured data
- fixIsolated margin liquidation formula corrected for OKX fee structure
v1.0.0launchJanuary 20, 2026
- newInitial release: PnL and Liquidation Price calculators
- newBinance and Bybit exchange support
- newTelegram bot @perpcalcbot