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.
Scope and legal notice
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.
Documentation and project links
- Source repository
- API documentation and tutorials
- Issue tracker
- Security policy
- Imprint
- Privacy policy
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)
| 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)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| 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 logRelease 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 logSecurity 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.
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 logA 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.