XXFIN

Install

Install the consumer package:

pip install py10x-fin-base
# or: uv pip install py10x-fin-base

That pulls py10x-fin-base-cxx transitively (import cxxfin). Do not depend on the cxx dist directly. Requires Python >=3.11,<3.14 and a published py10x-core (plus its kernel/infra).

To also use the AADC JIT-compiled path (see below), install the aadc extra from MatLogica's own package index -- PyPI only mirrors an older 1.x line:

pip install "py10x-fin-base[aadc]" --extra-index-url https://matlogica.com/wheels/simple/
# or: uv pip install "py10x-fin-base[aadc]" --extra-index-url https://matlogica.com/wheels/simple/

In this monorepo the packaging root is xx_fin/. Domain developers typically use uv-sync py10x-dev --all-extras --with-downstream from the py10x repo root — see CONTRIBUTING.md.

from xxfin.ccy import Ccy
import cxxfin  # native extension from py10x-fin-base-cxx

About

xxfin (py10x-fin-base) is the first subject domain of 10x Genaxy.

The package serves a dual purpose:

• to illustrate how a subject domain might use the capabilities of the substratum of 10x Genaxy (py10x-core) by implementing a sufficiently rich example solving an important problem in an important subject domain
• to provide a complete working implementation of the most foundational valuation problem in the financial domain: calculating today's price of a fixed amount of a future cash flow denominated in any currency.

To achieve this goal, one needs to determine the relevant currency/foreign exchange (FX) rates and discount factors in a manner consistent with the current market data. Hence, we define all the necessary data structures for market data, including:

• an ingestion/translation facility for collecting market data from any chosen data providers
• generation/population/storage objects for standard quoted market data
• models for calibrating complex/"synthetic" objects (forward curves), allowing calculation of rates/values that are not directly observable but are consistent with all the relevant markets

The sequence of the valuation steps is as follows:

• We create market data objects ("quotables") that contain the market quotes and are stored in a user-specified market data store.
• The user specifies an external market data provider.
• An adapter is needed to translate the market data from the provider's format and populate our quotables.
  • We may provide such an adapter for a commonly used provider (e.g., Bloomberg), and, at a later date, add more adapters if demand warrants it.
  • We create a sample set of quotables which allow us to illustrate the use of market data.
• Each piece of market data is quoted as a number (or a collection of numbers) representing values/parameters of certain standard financial contracts, and the set of specifications sufficient to describe and value such standardized contracts is saved in "market convention" objects.

The subset of all market quotables used to build/calibrate synthetic market data (forward curves) is called a market assembly. It usually consists of the most liquid contracts that provide the most precise view of market participants on the market (e.g., the most liquid swap or FX forward quotes). Once we ingest the market quotes from the data provider(s) into the quotables, we use a market assembly to build/calibrate the forward curve using a chosen calibration procedure. The subsequent use of the curves built this way is completely agnostic to the curve calibration choices. Hence, the market assembly, as well as the calibration analytics, can be replaced by the user's preferred choices.

The discount curve for a discount rate in a given currency is built using that currency-denominated standard cash deposit and fixed-floating swap market quotes, with that rate as the underlying/reference floating rate for the instruments listed in a market assembly (e.g., for the SOFR curve we use USD cash deposits and SOFR standard annual fixed/floating swap quotes).

For FX forward curve construction, we currently use FX spot and FX forward (point) quotes for rates funded/collateralized in the same currency (e.g., USD). We build an FX curve for a market assembly-specified set of FX spot and FX USD-collateralized forwards consistent with the funding currency's discount curve.

Such an FX forward curve allows us to calculate the present value, in any given currency, of a cash flow denominated in any other currency.

Optional JIT acceleration via AADC

Install the aadc extra first -- see Install. xxfin/jit_aadc/ optionally records curve/valuation code into a JIT-compiled adjoint differentiation kernel using MatLogica's AADC (Adjoint Algorithmic Differentiation Compiler), enabled via the use_cxxfin setting in xxfin_env_vars.py. xxfin itself works fully without it -- AADC only accelerates the JIT-compiled code path. See xxfin/jit_aadc/aadc_doc.md and xxfin/jit_aadc/aadc_kernel_doc.md for how it's used.

An easy setup to start playing with xxfin package

• install mongodb on your machine and run without authentication (default)
• set environment variables:
  • XX_MAIN_TS_STORE_URI=mongodb://localhost/xx_fin (or any other MongoDb)
  • XXFIN_DEFAULT_PRICING_CONTEXT_NAME=Abu Dhabi 20251010
• run xxfin/dev_data_helpers/RUN_ME.py (it will store a number of objects)
• you are ready to go!