Pular para conteúdo

NTN-B Principal

dv01(data_liquidacao, data_vencimento, taxa, vna)

Calcula o DV01 (Dollar Value of 01) da NTN-B Principal em R$.

Representa a variação de preço para um aumento de 1 bp (0,01%) na taxa.

Parameters:

Name Type Description Default
data_liquidacao DateLike

Data de liquidação.

 required
data_vencimento DateLike

Data de vencimento.

 required
taxa float

Taxa de desconto (YTM) do título.

 required
vna float

Valor nominal atualizado (VNA).

 required

Returns:

Name Type Description
float float

DV01 (Dollar Value of 01), variação de preço para 1 bp.

Examples:

>>> from pyield import ntnbprinc as bp
>>> bp.dv01("02-12-2025", "15-05-2029", 0.0777, 4567.033825)
1.1200559999997495
Source code in pyield/ntnbprinc.py 
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
def dv01(
    data_liquidacao: DateLike,
    data_vencimento: DateLike,
    taxa: float,
    vna: float,
) -> float:
    """
    Calcula o DV01 (Dollar Value of 01) da NTN-B Principal em R$.

    Representa a variação de preço para um aumento de 1 bp (0,01%) na taxa.

    Args:
        data_liquidacao (DateLike): Data de liquidação.
        data_vencimento (DateLike): Data de vencimento.
        taxa (float): Taxa de desconto (YTM) do título.
        vna (float): Valor nominal atualizado (VNA).

    Returns:
        float: DV01 (Dollar Value of 01), variação de preço para 1 bp.

    Examples:
        >>> from pyield import ntnbprinc as bp
        >>> bp.dv01("02-12-2025", "15-05-2029", 0.0777, 4567.033825)
        1.1200559999997495
    """
    if any_is_empty(data_liquidacao, data_vencimento, taxa, vna):
        return float("nan")

    preco_1 = pu(data_liquidacao, data_vencimento, taxa, vna)
    preco_2 = pu(data_liquidacao, data_vencimento, taxa + 0.0001, vna)
    return preco_1 - preco_2

pu(data_liquidacao, data_vencimento, taxa, vna)

Calcula o preço (PU) da NTN-B Principal pelas regras do Tesouro Nacional.

Parameters:

Name Type Description Default
data_liquidacao DateLike

Data de liquidação.

 required
data_vencimento DateLike

Data de vencimento.

 required
taxa float

Taxa de desconto (YTM) do título.

 required
vna float

Valor nominal atualizado (VNA).

 required

Returns:

Name Type Description
float float

Preço (PU) da NTN-B Principal conforme as regras do Tesouro Nacional.
References
  • https://www.anbima.com.br/data/files/A0/02/CC/70/8FEFC8104606BDC8B82BA2A8/Metodologias%20ANBIMA%20de%20Precificacao%20Titulos%20Publicos.pdf

Examples:

>>> from pyield import ntnbprinc
>>> ntnbprinc.pu("02-12-2025", "15-05-2029", 0.0777, 4567.033825)
3537.763157
Source code in pyield/ntnbprinc.py 
 6
 7
 8
 9
10
11
12
13
14
15
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
def pu(
    data_liquidacao: DateLike,
    data_vencimento: DateLike,
    taxa: float,
    vna: float,
) -> float:
    """
    Calcula o preço (PU) da NTN-B Principal pelas regras do Tesouro Nacional.

    Args:
        data_liquidacao (DateLike): Data de liquidação.
        data_vencimento (DateLike): Data de vencimento.
        taxa (float): Taxa de desconto (YTM) do título.
        vna (float): Valor nominal atualizado (VNA).

    Returns:
        float: Preço (PU) da NTN-B Principal conforme as regras do Tesouro Nacional.

    References:
        - https://www.anbima.com.br/data/files/A0/02/CC/70/8FEFC8104606BDC8B82BA2A8/Metodologias%20ANBIMA%20de%20Precificacao%20Titulos%20Publicos.pdf

    Examples:
        >>> from pyield import ntnbprinc
        >>> ntnbprinc.pu("02-12-2025", "15-05-2029", 0.0777, 4567.033825)
        3537.763157
    """
    if any_is_empty(data_liquidacao, data_vencimento, taxa, vna):
        return float("nan")

    # Calcula dias úteis entre liquidação e vencimento
    dias_uteis = du.contar(data_liquidacao, data_vencimento)

    # Calcula anos úteis truncados conforme ANBIMA
    anos_uteis = utils.truncar(dias_uteis / 252, 14)

    fator_desconto = (1 + taxa) ** anos_uteis

    # Trunca o preço em 6 casas conforme ANBIMA
    return utils.truncar(vna / fator_desconto, 6)