fin-infra / API Reference

RecurringDetector

from fin_infra.recurring.detector import RecurringDetector

fin_infra.recurring.detector

High-level recurring transaction detector. Provides easy-to-use interface for detecting recurring patterns. V2: Optional LLM enhancement for merchant normalization (Layer 2), variable amount detection (Layer 4), and insights generation (Layer 5).

Constructor

RecurringDetector(min_occurrences: int = 3, amount_tolerance: float = 0.02, date_tolerance_days: int = 7, merchant_normalizer: MerchantNormalizer | None = None, variable_detector_llm: VariableDetectorLLM | None = None, insights_generator: SubscriptionInsightsGenerator | None = None)

Parameter	Type	Default	Description
`min_occurrences`	`int`	3	Minimum transactions to detect pattern (default: 3)
`amount_tolerance`	`float`	0.02	Amount variance tolerance (default: 0.02 = 2%)
`date_tolerance_days`	`int`	7	Date clustering tolerance (default: 7 days)
`merchant_normalizer`	`MerchantNormalizer \|None`	None	Optional LLM merchant normalizer (Layer 2, V2)
`variable_detector_llm`	`VariableDetectorLLM \|None`	None	Optional LLM variable detector (Layer 4, V2)
`insights_generator`	`SubscriptionInsightsGenerator \|None`	None	Optional LLM insights generator (Layer 5, V2)

RecurringDetector

Methods

RecurringDetector

Methods