# TrueMath

## Docs

- [Authentication](https://docs.truemath.ai/api/authentication.md): Authenticate TrueMath API requests with a bearer API key. How to create a key, send it, and rotate or revoke it.
- [Calculate](https://docs.truemath.ai/api/calculate.md): Run a calculation with natural language or structured input via POST /v1/calculate, and read the result, provenance, and scenario it produces.
- [Conversations](https://docs.truemath.ai/api/conversations.md): List conversations and retrieve a conversation's full message history, including the results and errors of each calculation.
- [Domains](https://docs.truemath.ai/api/domains.md): List the published domains available to your account, and read a domain's variables and activities.
- [Errors](https://docs.truemath.ai/api/errors.md): How the TrueMath API reports transport-level errors via HTTP status codes, and calculation errors within a successful response.
- [Limits](https://docs.truemath.ai/api/limits.md): Pagination and request idempotency for the TrueMath REST API.
- [API overview](https://docs.truemath.ai/api/overview.md): Base URL, versioning, authentication, and conventions for the TrueMath REST API.
- [Scenarios](https://docs.truemath.ai/api/scenario-context.md): Retrieve the resolved domains, activities, and variables for every scenario in a conversation, or for a single scenario.
- [Authoring charts](https://docs.truemath.ai/authoring/charts.md): Display a table-valued variable as a bar or pie chart, and configure its series, labels, and slices.
- [Creating a domain](https://docs.truemath.ai/authoring/creating-a-domain.md): Create a new calculation domain — set its title and description, build it up from activities and variables, and import, export, copy, or archive it.
- [Customizing a library domain](https://docs.truemath.ai/authoring/customizing-a-library-domain.md): Adapt a pre-built domain to your own conventions, regulatory requirements, or business logic.
- [Defining variables](https://docs.truemath.ai/authoring/defining-variables.md): Configure a variable's key, labels, display type, decimal format, and default value with its unit.
- [The domain definition](https://docs.truemath.ai/authoring/domain-definition.md): The JSON shape of a domain — its domain object, variables, and activities — as exported, imported, and authored. The complete structure of a TrueMath domain.
- [Natural language domain creation](https://docs.truemath.ai/authoring/natural-language-domain-creation.md): Describe a calculation workflow in plain language and generate a structured domain definition.
- [Authoring overview](https://docs.truemath.ai/authoring/overview.md): How to create, version, publish, and archive calculation domains in TrueMath.
- [Authoring tables](https://docs.truemath.ai/authoring/tables.md): Define a table-valued variable — its columns, per-column format, row labels, starting row index, and an optional default table.
- [Testing and publishing](https://docs.truemath.ai/authoring/testing-and-publishing.md): Test a domain draft by running calculations against it, then publish it so calculations can use it — or revert the draft.
- [A worked domain: contractor estimating](https://docs.truemath.ai/authoring/worked-example-estimating.md): Build a small contractor-estimating domain end to end — loaded labor rates, markup versus margin, a bid price that solves in several directions, and a cash-flow chart.
- [Writing activities](https://docs.truemath.ai/authoring/writing-activities.md): Define an activity — its equation, the variables it relates, and which of those variables it is allowed to solve for.
- [Writing equations](https://docs.truemath.ai/authoring/writing-equations.md): Write TrueMath activity equations — literals, variables, operators, functions, units in backticks, and how scalar, unit, and table values combine.
- [Activities](https://docs.truemath.ai/concepts/activities.md): Activities are the equation units of a domain. Each activity relates a set of variables and can solve for different variables depending on which values are known.
- [Domains](https://docs.truemath.ai/concepts/domains.md): A domain is a collection of variables and activities that models a specific area of calculation, such as a mortgage or a construction estimate.
- [Input formats](https://docs.truemath.ai/concepts/input-formats.md): How calculation inputs are expressed — natural language prose, structured text key/value lines, or a JSON object. Natural language and structured text work in the Playground and over the API; JSON is API-only.
- [Provenance](https://docs.truemath.ai/concepts/provenance.md): Every variable value records where it came from — user-stated, calculated, carried forward, or default. Provenance is what makes a result accountable.
- [Scenarios](https://docs.truemath.ai/concepts/scenarios.md): A scenario is a distinct calculation state within a conversation. Scenarios let you explore what-if outcomes without losing prior work.
- [Units and precision](https://docs.truemath.ai/concepts/units-and-precision.md): TrueMath carries units with values and converts compatible units automatically, and it maintains full precision across every step of a calculation.
- [Variables](https://docs.truemath.ai/concepts/variables.md): Variables are the named values a domain calculates with. Each is defined by a key, type, display format, and optional default, and carries a value with its unit and provenance when a calculation runs.
- [Versioning](https://docs.truemath.ai/concepts/versioning.md): Domains move through a draft-to-published lifecycle so calculation logic is explicit and controlled. Calculations run against the published version.
- [Domain library](https://docs.truemath.ai/domain-library/overview.md): Browse TrueMath's library of pre-built, role-based calculation domains across professional verticals.
- [Guarantees](https://docs.truemath.ai/introduction/guarantees.md): What deterministic execution gives you: reproducible results, full precision across every step, provenance for every value, and versioned business logic.
- [How TrueMath fits with LLMs](https://docs.truemath.ai/introduction/how-it-fits-with-llms.md): LLMs reason and parse intent; TrueMath executes the math deterministically. How the two layers work together today, and why the boundary between them is permanent.
- [What is TrueMath](https://docs.truemath.ai/introduction/what-is-truemath.md): TrueMath is a deterministic math execution engine for AI-native workflows. LLMs reason and parse intent; TrueMath executes the math — at full precision, with provenance, against versioned business logic.
- [Arithmetic and powers](https://docs.truemath.ai/math/functions/arithmetic-and-powers.md): Core arithmetic, percent change, modulo, powers and roots, and logarithmic and exponential functions.
- [Conditionals and logic](https://docs.truemath.ai/math/functions/conditionals-and-logic.md): Branch with if and choose, repeat with loop, and combine conditions with comparison and logical operators.
- [Finance](https://docs.truemath.ai/math/functions/finance.md): Time-value-of-money and amortization functions, uniform and single-payment series, interest-rate conversion, and cash-flow analysis — with their unit rules.
- [Function library](https://docs.truemath.ai/math/functions/index.md): An index of TrueMath's built-in functions by category — arithmetic, trigonometry, statistics, finance, tables, and more.
- [Operators and precedence](https://docs.truemath.ai/math/functions/operators-and-precedence.md): TrueMath's arithmetic, comparison, logical, and assignment operators, and the order of operations used to evaluate them.
- [Rounding and numeric](https://docs.truemath.ai/math/functions/rounding-and-numeric.md): Rounding, truncation, absolute value, sign, and integer/fractional-part functions.
- [Statistics](https://docs.truemath.ai/math/functions/statistics.md): Aggregation, dispersion, and combinatorics functions: sum, average, min/max, median, quartiles, standard deviation, variance, factorial, permutations, and combinations.
- [Table functions](https://docs.truemath.ai/math/functions/tables.md): Functions for measuring, accessing, searching, sorting, and combining table data.
- [Trigonometry](https://docs.truemath.ai/math/functions/trigonometry.md): Trigonometric, inverse, and hyperbolic functions, including how angle units are interpreted.
- [Unit functions](https://docs.truemath.ai/math/functions/units.md): Read a value's unit with unit, and extract its numeric portion — optionally converted to a target unit — with unitvalue.
- [Scalar numbers](https://docs.truemath.ai/math/types/scalar-numbers.md): Plain numeric values with no unit — the simplest value type in TrueMath.
- [Tables](https://docs.truemath.ai/math/types/tables.md): One- or two-dimensional collections of values with per-cell units. How tables are written in equations, stored and returned, and combined with element-wise operations.
- [Unit numbers](https://docs.truemath.ai/math/types/unit-numbers.md): Numeric values that carry a unit. TrueMath converts compatible units automatically and rejects incompatible ones.
- [Units](https://docs.truemath.ai/math/units.md): The catalog of units TrueMath supports across length, area, volume, mass, time, angle, information, and currency, plus compound units and conversion behavior.
- [Input formats](https://docs.truemath.ai/playground/input-formats.md): Enter Playground calculations as natural language or as structured text.
- [Reading results](https://docs.truemath.ai/playground/reading-results.md): Interpret Playground results: variable values, provenance, scenario index, and display types.
- [Playground tour](https://docs.truemath.ai/playground/tour.md): A guided tour of the TrueMath Playground for running and exploring calculations.
- [What-if scenarios](https://docs.truemath.ai/playground/what-if-scenarios.md): Explore alternative outcomes by adjusting inputs to create new scenarios in the Playground.
- [Quickstart](https://docs.truemath.ai/quickstart.md): Run your first TrueMath calculation in the Playground, then make the same call through the API.
- [Changelog](https://docs.truemath.ai/resources/changelog.md): Notable changes to TrueMath and its documentation.
- [Compliance and security](https://docs.truemath.ai/resources/compliance-and-security.md): TrueMath's data segregation, access controls, and compliance posture.
- [FAQ](https://docs.truemath.ai/resources/faq.md): Frequently asked questions about TrueMath.
- [Glossary](https://docs.truemath.ai/resources/glossary.md): Canonical TrueMath terminology: domain, activity, variable, provenance, scenario, and the other terms used consistently throughout the documentation.

## Optional

- [Blog](https://blog.truemath.ai)