Optiqo
Technical documentation · Optiqo

Documentation

How Optiqo is built — methodology, data lineage, APIs, architecture, embed widgets, changelog. Everything you'd want to verify before trusting an output.

Documentation index

→ /docs/engine

Tax engine methodology

How the engine combines federal, cantonal, and commune scales. Special cases (GE additive, BL formula, VS rebate, NE coefficient, splitting divisors).

→ /docs/data

Data sources

Per-canton data lineage: which PDF/CSV/HTML page we pulled it from, when, and how we transformed it.

→ /docs/api

HTTP API reference

All 24 public and authenticated endpoints — calculator, atlas, levers, equity, withdrawal, move, mortgage, crypto, newsletter, checkout.

→ /docs/architecture

System architecture

Stack overview, deployment topology, data flow, security model, performance targets.

→ /docs/embed

Embed widget

How to embed the atlas or commune dossier as an iframe in any partner site. Free, with attribution.

→ /docs/changelog

Changelog

Versioned timeline of feature releases, data refreshes, and breaking changes.

Status

  • ~2 060 communes across 26 cantons, refreshed yearly via authoritative cantonal sources.
  • 26 of 26 cantonal tax scales transcribed from ESTV Kantonsblätter 2026.
  • 57 / 57 engine tests passing.
  • 12 free calculators: main, couples, equity, 3a-withdrawal, move, mortgage, frontalier, crypto, plus comparisons + atlas.
  • 9 educational articles: 3a, LPP buy-in (mechanic + how-to), Steuerfuss, Individualbesteuerung, cantonal federation, marriage penalty, crypto, filing.
  • 3 embed widgets: atlas, commune dossier, plus the docs page.
  • 1 newsletter, double-opt-in via Resend.
  • Live at optiqo.ch.

Open methodology

Every numerical assumption Optiqo uses is documented. Every commune's Steuerfuss carries a source attribution string (e.g. “fin.be.ch Steueranlage 2026 (PDF)”). Every cantonal scale lists its ESTV Kantonsblatt source. The federal scale comes from the ESTV Kreisschreiben.

If you find an error or have a question, email hello@optiqo.ch with the page URL and the discrepancy. We respond within 48 hours.