Skip to main content

financial-instruments-accounting

financial-instruments-accounting is an auditable, offline-capable Python library for granular financial instrument accounting calculations and reference workflows. It provides typed building blocks for classification, measurement, impairment, hedge accounting, journal preparation, disclosures and model monitoring in one reproducible package.

The methodology is designed around financial instrument accounting concepts in IFRS 9 and related presentation and disclosure interfaces. The project name is independent of the standard. The library is not affiliated with, endorsed by or certified by the IFRS Foundation or any standard setter.

Capabilities

The package exposes 80 documented public functions across five stable modules: formulas, domains, data, workflow and models.

  • Scope, recognition, derecognition and continuing involvement
  • Business-model and contractual-cash-flow characteristic assessments
  • Classification and reclassification reference decisions
  • Initial measurement, effective interest rates, amortised cost and interest revenue, including purchased or originated credit-impaired instruments
  • Multi-scenario expected credit losses using PD/LGD/EAD components, discounted cash shortfalls or provision matrices
  • Staging, significant-increase-in-credit-risk assessment, overlays, collateral allocation, modifications, write-offs and recoveries
  • Fair-value presentation, own-credit separation and OCI rollforwards
  • Hedge eligibility, effectiveness, lower-of measurement, reserve movements, recycling and basis adjustments
  • Journal preparation, allowance and gross-carrying-amount rollforwards, disclosure facts and regulatory bridges
  • PD, LGD, EAD and staging backtesting, challenger comparison, scenario sensitivity and audit controls
  • Bitemporal input selection, strict validation, resource hashes and result lineage

Installation and first run

python -m pip install financial-instruments-accounting

The distribution name uses hyphens; the Python import namespace is financial_accounting_engine.

import financial_accounting_engine as fae

eir = fae.effective_interest_rate(1000, [(1, 1100)])
assert abs(eir - 0.1) < 1e-9

dataset = fae.load_reference_data("SMALL_SA_RETAIL_FIA")
result = fae.run_dataset(dataset)
assert result.status == "APPROVED_REFERENCE"
print(fae.get_metrics(result))

The command-line interface uses the same public workflow:

financial-instruments-accounting doctor
financial-instruments-accounting profiles
financial-instruments-accounting reference SMALL_SA_RETAIL_FIA --output ./results

Reference data and reproducibility

Two complete synthetic profiles are bundled for offline examples, integration tests and cross-implementation comparison. Each profile contains 19 sealed XLSX input workbooks plus canonical JSON data. No client, bank or personal data are included.

Reference calculations are checked against independently specified formula cases and frozen full-profile results. The repository also contains API-contract tests, property tests, correction evidence, resource manifests and installed wheel/sdist smoke tests. GitHub Actions verifies Python 3.10 through 3.13.

APPROVED_REFERENCE means that the package's automated reference controls have passed. It is not an institutional approval, an audit opinion or an accounting conclusion. Users remain responsible for contract interpretation, accounting policy choices, approved models and parameters, market data, materiality, governance, ledger integration and financial-statement review.

The software does not implement every requirement, exception or disclosure in IFRS Accounting Standards and is not a substitute for the standards or for professional accounting, audit, legal or risk advice. Official source metadata and links are provided for traceability; standard texts and other third-party materials are not redistributed. Obtain authoritative, current materials from their publishers and observe their terms.

The Apache License 2.0 applies to this software and its synthetic project data. It does not grant rights in third-party standards, publications or trademarks. See DISCLAIMER.md, THIRD_PARTY_NOTICES.md and NOTICE in the source repository.

Copyright 2026 RiskDataScience GmbH. Maintainer contact: riskdatascience@web.de.

Metadata

Release files for financial-instruments-accounting 1.0.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for financial-instruments-accounting 1.0.0
File Size Uploaded Provenance Actions
financial_instruments_accounting-1.0.0.tar.gz 564.1 kB With provenance Details for financial_instruments_accounting-1.0.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for financial-instruments-accounting 1.0.0
File Interpreter ABI Platform Actions
financial_instruments_accounting-1.0.0-py3-none-any.whl Python 3 none any Details for financial_instruments_accounting-1.0.0-py3-none-any.whl

Total release size: 1.2 MB

Release files / financial_instruments_accounting-1.0.0.tar.gz

Download URL financial_instruments_accounting-1.0.0.tar.gz
Size 564.1 kB
Tags Source
SHA-256 checksum
How to use checksums
af9141e571a87ce1eaf68d67e361c1fe68e531eaf04dc6e9d55c733dd3afbd97
BLAKE2b-256 checksum
How to use checksums
e6e7688ce3ca6528b3866ed7a2d1224e3164ba2a5f5cea50666198d4e2bc2d4e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 21, 2026.

Transparency log

Release files / financial_instruments_accounting-1.0.0-py3-none-any.whl

Download URL financial_instruments_accounting-1.0.0-py3-none-any.whl
Size 682.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
5fc62bedfd2a24c2759b6556f729f2751c101528ae3d4cdb32f88f1987aa7317
BLAKE2b-256 checksum
How to use checksums
047c60c85eeab6d5f4c482d6b25adf8bb5c5e2bca1e6c09a66001b0995d80c9d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 21, 2026.

Transparency log

Security for financial-instruments-accounting 1.0.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for financial_instruments_accounting-1.0.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 21, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

1.0.0 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page