Skip to content

CRR (Cox-Ross-Rubinstein) Technique#

Bases: LatticeTechnique

Cox-Ross-Rubinstein binomial lattice technique.

Source code in src/quantfin/techniques/crr.py 
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
class CRRTechnique(LatticeTechnique):
    """Cox-Ross-Rubinstein binomial lattice technique."""

    def _price_and_get_nodes(
        self,
        option: Option,
        stock: Stock,
        model: BaseModel,
        rate: Rate,
    ) -> dict[str, Any]:
        """
        Prices the option using the CRR kernel.

        This method extracts the necessary numerical parameters from the input
        objects and passes them to the low-level `_crr_pricer` kernel.

        Parameters
        ----------
        option : Option
            The option contract to be priced.
        stock : Stock
            The underlying asset's properties.
        model : BaseModel
            The financial model, used to get volatility.
        rate : Rate
            The risk-free rate structure.

        Returns
        -------
        dict[str, Any]
            A dictionary from the kernel containing the price and node values.
        """
        sigma = model.params.get("sigma", stock.volatility)
        return _crr_pricer(
            S0=stock.spot,
            K=option.strike,
            T=option.maturity,
            r=rate.get_rate(option.maturity),
            q=stock.dividend,
            sigma=sigma,
            N=self.steps,
            is_call=(option.option_type is OptionType.CALL),
            is_am=self.is_american,
        )