Skip to main content

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 graph
  • flatland: Solvency metrics (H⁰)
  • loop: Loop risk metrics (H¹)
  • void: Void risk metrics (H²) — requires econiac
  • risk_summary(): One-line risk assessment

Loop Metrics

  • beta_1(graph): Compute β₁ (independent funding loops)
  • load_factor(beta_1, num_edges): Compute ρ = β₁/m
  • beta_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 matrix
  • delta_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)

Source distribution for flovo 0.1.0
File Size Uploaded
flovo-0.1.0.tar.gz 6.1 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for flovo 0.1.0
File Interpreter ABI Platform
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

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files

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