# Funding Docs

`fuggers_py.funding` is the domain-first funding and repo layer.

## Current Scope

- `RepoTrade` as the core repo instrument
- `RepoCurve` as a lightweight funding-curve wrapper
- carry, implied-repo, specialness, and haircut-financing helpers
- explicit public helpers including `financed_cash`, `haircut_amount`, `haircut_drag`, `repo_financing_cost`, `repo_carry_return`, `repo_net_carry`, `specialness_value`, `is_special`, `implied_repo_rate_from_trade`, `futures_invoice_amount`, and `all_in_financing_cost`
- `RepoQuote`, `HaircutQuote`, and `RepoReferenceData` shared data records

## Notes

- The layer stays domain-first: funding analytics depend on funding instruments and curves rather than on a bond-futures product class.
- `FundingPricingRouter` lives in `fuggers_py.engine` so the domain package does not depend upward on engine code.
- The structured examples focus on repo trade and repo-curve workflows; the narrower helper surface is covered primarily by unit tests and root-export checks.
- Repo rates and haircuts are raw decimals, while collateral prices remain percent-of-par and financing outputs are currency amounts.
