FLoVo: Flatland-Loop-Void Risk Framework
H^k Risk Stratification for Financial Networks
FLoVo is a Python framework for measuring three strata of financial risk that existing regulatory frameworks (Basel III, VaR, mean-variance optimisation) cannot simultaneously address.
The Three Strata
Flatland (H⁰): Solvency Risk
Question: Can the institution pay its debts?
Measured by: NAV, funding ratio, CET1 capital ratio
Existing instruments: Basel III capital requirements
Status: Adequately regulated
Loop (H¹): Liquidity/Topology Risk
Question: Can it unwind without cascading?
Measured by: β₁ (number of independent funding loops), ρ = β₁/m (load factor), β*(ρ) (critical threshold)
Critical threshold: ρ* ≈ 0.931
Existing instruments: LCR, NSFR, LDI
Status: Partially addressed — miss network-level loops
Void (H²): Systemic Topology Risk
Question: Can the network resolve itself?
Measured by: β₂ (irresolvable conflict cycle count), ΔΔβ₂(i) (marginal contribution per institution)
Existing instruments: G-SIB buffer (proxy only)
Status: NOT regulated — missing from all frameworks
Historical Void Events
All appeared safe on Flatland and Loop metrics until catastrophic failure:
- LTCM (1998): Spread trade topology irresolvable; Fed consortium required
- Lehman/2008: Repo collateral chain conflicts; bilateral resolution impossible
- UK LDI Crisis (2022): Correlated pension fund gilt margin calls; Bank of England intervention required
Quick Start
from flovo import FLoVoProfile
import networkx as nx
# Create or load an exposure graph (nodes=institutions, edges=exposures)
graph = nx.Graph()
# ... add nodes and edges ...
# Compute FLoVo profile
profile = FLoVoProfile.from_graph(graph, nav=1000.0, liabilities=500.0)
# Access risk metrics
print(profile.flatland()) # Solvency
print(profile.loop()) # Loop risk + regime
print(profile.void()) # Void risk (requires econiac integration)
# Risk summary
print(profile.risk_summary())
Installation
pip install flovo
With Full Features (including Void risk)
pip install flovo[finance] # econiac.forge integration for β₂ computation
API Reference
FLoVoProfile
Main entry point for risk assessment.
from_graph(graph, nav, liabilities): Create profile from exposure graphflatland: Solvency metrics (H⁰)loop: Loop risk metrics (H¹)void: Void risk metrics (H²) — requires econiacrisk_summary(): One-line risk assessment
Loop Metrics
beta_1(graph): Compute β₁ (independent funding loops)load_factor(beta_1, num_edges): Compute ρ = β₁/mbeta_star(rho): Compute β*(ρ) = (3/8)ln(1/(1-ρ))- Risk regimes: SAT (<30%), MUSHY (30-70%), UNSAT (70-95%), CRITICAL (>95%)
Void Metrics (Requires econiac.forge)
beta_2(B2_matrix): Compute β₂ from conflict matrixdelta_beta_2(institution, B2): Compute ΔΔβ₂(i) — marginal systemic contribution
References
-
Paper 426 (Beyond Basel): doi:10.5281/zenodo.20701683
- Regulatory framework for systemic topology risk
-
Paper 429 (The Cohomological Fund Manager): doi:10.5281/zenodo.20702221
- FLoVo application to asset allocation, ALM, and portfolio management
-
Paper 430 (The Topology of Intermediation): doi:10.5281/zenodo.20702223
- FLoVo application to broker-dealers and prime brokerage
-
Paper 431 (CCPs Reconsidered): doi:10.5281/zenodo.20702225
- FLoVo application to central counterparties and default waterfalls
License
MIT License
Author
Ian R. C. Buckley (ian.r.c.buckley@gmail.com)
Release files for flovo 0.1.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 | |
|---|---|---|---|
| flovo-0.1.0.tar.gz | 6.1 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| flovo-0.1.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 14.5 kB
Release files / flovo-0.1.0.tar.gz
| Download URL | flovo-0.1.0.tar.gz |
|---|---|
| Size | 6.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
8baacaa119d0bc65e2574037b18d4e9bcf4bc10e7a16db6af340c21083b2ad4d
|
|
BLAKE2b-256 checksum How to use checksums |
363f1975463c47cbbef037a79959c5b90e002136fc2f3c46790049cceff261d1
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.13.7
|
Release files / flovo-0.1.0-py3-none-any.whl
| Download URL | flovo-0.1.0-py3-none-any.whl |
|---|---|
| Size | 8.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
9b4abcd4bfcdeeb457b87330a442941c756095bec6d76da8325938c450e04c94
|
|
BLAKE2b-256 checksum How to use checksums |
3d7b1d82f4d1f45337e95188cd2695657a659ee34c0ecd8d50c675d9e7d577b0
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.13.7
|