cdfi-benchmark 0.1.0__tar.gz

cdfi_benchmark-0.1.0/PKG-INFO

@@ -0,0 +1,143 @@
+Metadata-Version: 2.4
+Name: cdfi-benchmark
+Version: 0.1.0
+Summary: CDFI and MDI peer benchmarking tool using FDIC call report data — NIM, efficiency ratio, ROAA, CET1, and more
+License: MIT
+Project-URL: Homepage, https://github.com/Jaypatel1511/cdfi-benchmark
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: pandas>=1.4.0
+Requires-Dist: numpy>=1.21.0
+Requires-Dist: requests>=2.27.0
+
+# cdfi-benchmark 📊
+
+**CDFI and MDI peer benchmarking tool using FDIC call report data.**
+
+Pull call report financials for any FDIC-insured CDFI or MDI, compute key performance
+metrics, build a peer group of similar institutions, and generate a benchmarking report
+— using the free FDIC BankFind Suite API, no API key required.
+
+---
+
+## Why cdfi-benchmark?
+
+CDFI banks and MDIs benchmark their performance against peers manually — pulling
+call report data from FFIEC, computing ratios in Excel, and building comparison
+tables by hand. cdfi-benchmark automates the entire workflow in Python.
+
+---
+
+## Installation
+
+    pip install cdfi-benchmark
+
+---
+
+## Quickstart
+
+    from cdfibenchmark import (
+        get_financials, build_peer_group,
+        generate_report, summary_table,
+    )
+
+    # Pull call report data for Broadway Federal Bank (CERT 57542)
+    institution = get_financials(cert=57542)
+
+    # Build peer group — similar asset size, no API key needed
+    peers = build_peer_group(institution, same_state=True)
+
+    # Generate benchmarking report
+    report = generate_report(institution, peers)
+    print(report)
+
+    # Get results as DataFrame
+    df = summary_table(institution, peers)
+
+---
+
+## Sample Data (No API Required)
+
+    from cdfibenchmark import build_sample_peer_group
+    from cdfibenchmark.data.schema import InstitutionProfile
+
+    institution = InstitutionProfile(
+        cert=57542,
+        name="Broadway Federal Bank",
+        city="Los Angeles",
+        state="CA",
+        report_date="20241231",
+        total_assets=655_000,
+        total_deposits=520_000,
+        net_loans=380_000,
+        net_income=1_950,
+        interest_income=28_000,
+        interest_expense=8_000,
+        non_interest_income=3_500,
+        non_interest_expense=22_000,
+        total_equity=48_000,
+        tier1_ratio=12.2,
+    )
+
+    peers = build_sample_peer_group(institution)
+    report = generate_report(institution, peers)
+    print(report)
+
+---
+
+## Metrics Computed
+
+| Metric | Description | Benchmark (Strong) |
+|--------|-------------|-------------------|
+| NIM | Net Interest Margin | >= 3.5% |
+| Efficiency Ratio | Non-interest expense / Revenue | <= 60% |
+| ROAA | Return on Average Assets | >= 1.0% |
+| ROAE | Return on Average Equity | >= 10% |
+| Tier 1 Capital Ratio | Regulatory capital ratio | >= 12% |
+| Loans-to-Deposits | Loan utilization | <= 80% |
+| NPL Ratio | Non-performing loans / Gross loans | <= 1.0% |
+| Reserve Coverage | Loan loss reserve / NPLs | >= 100% |
+
+---
+
+## Asset Size Buckets
+
+- micro — Under $50MM
+- small — $50MM to $250MM
+- medium — $250MM to $1B
+- large — $1B to $5B
+- mega — Over $5B
+
+---
+
+## Data Source
+
+FDIC BankFind Suite API — free public API, no authentication required.
+Data covers all FDIC-insured institutions with quarterly call report data
+since 1934.
+
+    https://banks.data.fdic.gov/api
+
+---
+
+## Running Tests
+
+    PYTHONPATH=. pytest tests/ -v
+
+27 tests across all modules.
+
+---
+
+## Who This Is For
+
+- CDFI banks and credit unions benchmarking against peers
+- MDI management teams preparing board reports
+- CDFI Fund analysts reviewing institution performance
+- Impact investors evaluating CDFI bank investments
+- Researchers studying community banking performance trends
+
+---
+
+## License
+
+MIT 2026 Jaypatel1511

cdfi_benchmark-0.1.0/README.md

@@ -0,0 +1,131 @@
+# cdfi-benchmark 📊
+
+**CDFI and MDI peer benchmarking tool using FDIC call report data.**
+
+Pull call report financials for any FDIC-insured CDFI or MDI, compute key performance
+metrics, build a peer group of similar institutions, and generate a benchmarking report
+— using the free FDIC BankFind Suite API, no API key required.
+
+---
+
+## Why cdfi-benchmark?
+
+CDFI banks and MDIs benchmark their performance against peers manually — pulling
+call report data from FFIEC, computing ratios in Excel, and building comparison
+tables by hand. cdfi-benchmark automates the entire workflow in Python.
+
+---
+
+## Installation
+
+    pip install cdfi-benchmark
+
+---
+
+## Quickstart
+
+    from cdfibenchmark import (
+        get_financials, build_peer_group,
+        generate_report, summary_table,
+    )
+
+    # Pull call report data for Broadway Federal Bank (CERT 57542)
+    institution = get_financials(cert=57542)
+
+    # Build peer group — similar asset size, no API key needed
+    peers = build_peer_group(institution, same_state=True)
+
+    # Generate benchmarking report
+    report = generate_report(institution, peers)
+    print(report)
+
+    # Get results as DataFrame
+    df = summary_table(institution, peers)
+
+---
+
+## Sample Data (No API Required)
+
+    from cdfibenchmark import build_sample_peer_group
+    from cdfibenchmark.data.schema import InstitutionProfile
+
+    institution = InstitutionProfile(
+        cert=57542,
+        name="Broadway Federal Bank",
+        city="Los Angeles",
+        state="CA",
+        report_date="20241231",
+        total_assets=655_000,
+        total_deposits=520_000,
+        net_loans=380_000,
+        net_income=1_950,
+        interest_income=28_000,
+        interest_expense=8_000,
+        non_interest_income=3_500,
+        non_interest_expense=22_000,
+        total_equity=48_000,
+        tier1_ratio=12.2,
+    )
+
+    peers = build_sample_peer_group(institution)
+    report = generate_report(institution, peers)
+    print(report)
+
+---
+
+## Metrics Computed
+
+| Metric | Description | Benchmark (Strong) |
+|--------|-------------|-------------------|
+| NIM | Net Interest Margin | >= 3.5% |
+| Efficiency Ratio | Non-interest expense / Revenue | <= 60% |
+| ROAA | Return on Average Assets | >= 1.0% |
+| ROAE | Return on Average Equity | >= 10% |
+| Tier 1 Capital Ratio | Regulatory capital ratio | >= 12% |
+| Loans-to-Deposits | Loan utilization | <= 80% |
+| NPL Ratio | Non-performing loans / Gross loans | <= 1.0% |
+| Reserve Coverage | Loan loss reserve / NPLs | >= 100% |
+
+---
+
+## Asset Size Buckets
+
+- micro — Under $50MM
+- small — $50MM to $250MM
+- medium — $250MM to $1B
+- large — $1B to $5B
+- mega — Over $5B
+
+---
+
+## Data Source
+
+FDIC BankFind Suite API — free public API, no authentication required.
+Data covers all FDIC-insured institutions with quarterly call report data
+since 1934.
+
+    https://banks.data.fdic.gov/api
+
+---
+
+## Running Tests
+
+    PYTHONPATH=. pytest tests/ -v
+
+27 tests across all modules.
+
+---
+
+## Who This Is For
+
+- CDFI banks and credit unions benchmarking against peers
+- MDI management teams preparing board reports
+- CDFI Fund analysts reviewing institution performance
+- Impact investors evaluating CDFI bank investments
+- Researchers studying community banking performance trends
+
+---
+
+## License
+
+MIT 2026 Jaypatel1511

cdfi_benchmark-0.1.0/cdfi_benchmark.egg-info/PKG-INFO

@@ -0,0 +1,143 @@
+Metadata-Version: 2.4
+Name: cdfi-benchmark
+Version: 0.1.0
+Summary: CDFI and MDI peer benchmarking tool using FDIC call report data — NIM, efficiency ratio, ROAA, CET1, and more
+License: MIT
+Project-URL: Homepage, https://github.com/Jaypatel1511/cdfi-benchmark
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: pandas>=1.4.0
+Requires-Dist: numpy>=1.21.0
+Requires-Dist: requests>=2.27.0
+
+# cdfi-benchmark 📊
+
+**CDFI and MDI peer benchmarking tool using FDIC call report data.**
+
+Pull call report financials for any FDIC-insured CDFI or MDI, compute key performance
+metrics, build a peer group of similar institutions, and generate a benchmarking report
+— using the free FDIC BankFind Suite API, no API key required.
+
+---
+
+## Why cdfi-benchmark?
+
+CDFI banks and MDIs benchmark their performance against peers manually — pulling
+call report data from FFIEC, computing ratios in Excel, and building comparison
+tables by hand. cdfi-benchmark automates the entire workflow in Python.
+
+---
+
+## Installation
+
+    pip install cdfi-benchmark
+
+---
+
+## Quickstart
+
+    from cdfibenchmark import (
+        get_financials, build_peer_group,
+        generate_report, summary_table,
+    )
+
+    # Pull call report data for Broadway Federal Bank (CERT 57542)
+    institution = get_financials(cert=57542)
+
+    # Build peer group — similar asset size, no API key needed
+    peers = build_peer_group(institution, same_state=True)
+
+    # Generate benchmarking report
+    report = generate_report(institution, peers)
+    print(report)
+
+    # Get results as DataFrame
+    df = summary_table(institution, peers)
+
+---
+
+## Sample Data (No API Required)
+
+    from cdfibenchmark import build_sample_peer_group
+    from cdfibenchmark.data.schema import InstitutionProfile
+
+    institution = InstitutionProfile(
+        cert=57542,
+        name="Broadway Federal Bank",
+        city="Los Angeles",
+        state="CA",
+        report_date="20241231",
+        total_assets=655_000,
+        total_deposits=520_000,
+        net_loans=380_000,
+        net_income=1_950,
+        interest_income=28_000,
+        interest_expense=8_000,
+        non_interest_income=3_500,
+        non_interest_expense=22_000,
+        total_equity=48_000,
+        tier1_ratio=12.2,
+    )
+
+    peers = build_sample_peer_group(institution)
+    report = generate_report(institution, peers)
+    print(report)
+
+---
+
+## Metrics Computed
+
+| Metric | Description | Benchmark (Strong) |
+|--------|-------------|-------------------|
+| NIM | Net Interest Margin | >= 3.5% |
+| Efficiency Ratio | Non-interest expense / Revenue | <= 60% |
+| ROAA | Return on Average Assets | >= 1.0% |
+| ROAE | Return on Average Equity | >= 10% |
+| Tier 1 Capital Ratio | Regulatory capital ratio | >= 12% |
+| Loans-to-Deposits | Loan utilization | <= 80% |
+| NPL Ratio | Non-performing loans / Gross loans | <= 1.0% |
+| Reserve Coverage | Loan loss reserve / NPLs | >= 100% |
+
+---
+
+## Asset Size Buckets
+
+- micro — Under $50MM
+- small — $50MM to $250MM
+- medium — $250MM to $1B
+- large — $1B to $5B
+- mega — Over $5B
+
+---
+
+## Data Source
+
+FDIC BankFind Suite API — free public API, no authentication required.
+Data covers all FDIC-insured institutions with quarterly call report data
+since 1934.
+
+    https://banks.data.fdic.gov/api
+
+---
+
+## Running Tests
+
+    PYTHONPATH=. pytest tests/ -v
+
+27 tests across all modules.
+
+---
+
+## Who This Is For
+
+- CDFI banks and credit unions benchmarking against peers
+- MDI management teams preparing board reports
+- CDFI Fund analysts reviewing institution performance
+- Impact investors evaluating CDFI bank investments
+- Researchers studying community banking performance trends
+
+---
+
+## License
+
+MIT 2026 Jaypatel1511

cdfi_benchmark-0.1.0/cdfi_benchmark.egg-info/SOURCES.txt

@@ -0,0 +1,24 @@
+README.md
+pyproject.toml
+setup.py
+cdfi_benchmark.egg-info/PKG-INFO
+cdfi_benchmark.egg-info/SOURCES.txt
+cdfi_benchmark.egg-info/dependency_links.txt
+cdfi_benchmark.egg-info/requires.txt
+cdfi_benchmark.egg-info/top_level.txt
+cdfibenchmark/__init__.py
+cdfibenchmark/data/__init__.py
+cdfibenchmark/data/fdic.py
+cdfibenchmark/data/schema.py
+cdfibenchmark/metrics/__init__.py
+cdfibenchmark/metrics/calculator.py
+cdfibenchmark/peers/__init__.py
+cdfibenchmark/peers/selector.py
+cdfibenchmark/report/__init__.py
+cdfibenchmark/report/generator.py
+tests/__init__.py
+tests/conftest.py
+tests/test_metrics.py
+tests/test_peers.py
+tests/test_report.py
+tests/test_schema.py

cdfi_benchmark-0.1.0/cdfi_benchmark.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

cdfi_benchmark-0.1.0/cdfi_benchmark.egg-info/requires.txt

@@ -0,0 +1,3 @@
+pandas>=1.4.0
+numpy>=1.21.0
+requests>=2.27.0

cdfi_benchmark-0.1.0/cdfi_benchmark.egg-info/top_level.txt

@@ -0,0 +1,2 @@
+cdfibenchmark
+tests

cdfi_benchmark-0.1.0/cdfibenchmark/__init__.py

@@ -0,0 +1,28 @@
+from cdfibenchmark.data.schema import (
+    InstitutionProfile, BenchmarkResult,
+    BENCHMARKS, ASSET_BUCKETS,
+)
+from cdfibenchmark.data.fdic import (
+    get_institution, get_financials,
+    search_institutions, get_peer_financials,
+)
+from cdfibenchmark.metrics.calculator import (
+    compute_peer_metrics, benchmark_institution, rank_institution,
+)
+from cdfibenchmark.peers.selector import (
+    build_peer_group, build_sample_peer_group,
+)
+from cdfibenchmark.report.generator import (
+    generate_report, summary_table,
+)
+
+__version__ = "0.1.0"
+__all__ = [
+    "InstitutionProfile", "BenchmarkResult",
+    "get_institution", "get_financials",
+    "search_institutions", "get_peer_financials",
+    "compute_peer_metrics", "benchmark_institution", "rank_institution",
+    "build_peer_group", "build_sample_peer_group",
+    "generate_report", "summary_table",
+    "BENCHMARKS", "ASSET_BUCKETS",
+]