PYield 0.46.4__tar.gz → 0.46.6__tar.gz

{pyield-0.46.4 → pyield-0.46.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pyield
-Version: 0.46.4
+Version: 0.46.6
 Summary: A Python library for analysis of fixed income instruments in Brazil
 Project-URL: Homepage, https://github.com/crdcj/PYield
 Project-URL: Documentation, https://crdcj.github.io/PYield

pyield-0.46.6/pyield/__about__.py

@@ -0,0 +1 @@
+__version__ = "0.46.6"

{pyield-0.46.4 → pyield-0.46.6}/pyield/b3/futures/historical.py

@@ -14,14 +14,16 @@ from pyield.fwd import forwards
 CONTRATOS_TAXA = {"DI1", "DAP", "DDI", "FRC", "FRO"}
 
 # Renomeação preco_* → taxa_* para contratos cotados por taxa.
+# Bid/Ask são invertidos: BestBidPric (bid em PU) = menor taxa = venda de taxa;
+# BestAskPric (ask em PU) = maior taxa = compra de taxa.
 _PRECO_PARA_TAXA = {
     "preco_abertura": "taxa_abertura",
     "preco_minimo": "taxa_minima",
     "preco_maximo": "taxa_maxima",
     "preco_medio": "taxa_media",
     "preco_fechamento": "taxa_fechamento",
-    "preco_ultima_oferta_compra": "taxa_ultima_oferta_compra",
-    "preco_ultima_oferta_venda": "taxa_ultima_oferta_venda",
+    "preco_ultima_oferta_compra": "taxa_ultima_oferta_venda",
+    "preco_ultima_oferta_venda": "taxa_ultima_oferta_compra",
     "preco_limite_minimo": "taxa_limite_minimo",
     "preco_limite_maximo": "taxa_limite_maximo",
 }
@@ -30,10 +32,10 @@ _PRECO_PARA_TAXA = {
 _RENOMEAR_COLUNAS_PR = {
     "TradDt": "data_referencia",
     "TckrSymb": "codigo_negociacao",
-    "TradQty": "numero_negocios",
-    "NtlFinVol": "volume_financeiro",
     "OpnIntrst": "contratos_abertos",
+    "TradQty": "numero_negocios",
     "FinInstrmQty": "volume_negociado",
+    "NtlFinVol": "volume_financeiro",
     "BestBidPric": "preco_ultima_oferta_compra",
     "BestAskPric": "preco_ultima_oferta_venda",
     "FrstPric": "preco_abertura",
@@ -43,7 +45,6 @@ _RENOMEAR_COLUNAS_PR = {
     "LastPric": "preco_fechamento",
     "AdjstdQt": "preco_ajuste",
     "AdjstdQtTax": "taxa_ajuste",
-    "AdjstdValCtrct": "valor_contrato_ajustado",
     "MaxTradLmt": "preco_limite_maximo",
     "MinTradLmt": "preco_limite_minimo",
 }
@@ -87,7 +88,6 @@ def historical(
         * numero_negocios (Int64): número de negócios.
         * volume_negociado (Int64): quantidade de contratos negociados.
         * volume_financeiro (Float64): volume financeiro bruto.
-        * valor_contrato_ajustado (Float64): valor do contrato ajustado.
         * preco_limite_minimo (Float64): limite mínimo de variação (preço).
         * preco_limite_maximo (Float64): limite máximo de variação (preço).
         * preco_abertura (Float64): preço de abertura.
@@ -107,10 +107,10 @@ def historical(
         * taxa_maxima (Float64): taxa máxima negociada.
         * taxa_media (Float64): taxa média negociada.
         * taxa_fechamento (Float64): última taxa negociada (last).
-        * taxa_ultima_oferta_compra (Float64): melhor taxa de compra
-          (bid) no fim do pregão.
         * taxa_ultima_oferta_venda (Float64): melhor taxa de venda
-          (ask) no fim do pregão.
+          (dar; bid em PU) no fim do pregão.
+        * taxa_ultima_oferta_compra (Float64): melhor taxa de compra
+          (tomar; ask em PU) no fim do pregão.
         * taxa_ajuste (Float64): taxa de ajuste.
         * taxa_forward (Float64): taxa a termo (apenas DI1/DAP).
 
@@ -122,7 +122,10 @@ def historical(
 
         ``*_fechamento`` é o último negócio realizado (last trade).
         ``*_ultima_oferta_*`` é o bid/ask ao fim do pregão — não
-        representa negócio realizado e pode ser nulo.
+        representa negócio realizado e pode ser nulo. Para contratos de
+        taxa (DI1, DAP, etc.), bid/ask são invertidos em relação ao PU:
+        ``taxa_ultima_oferta_compra`` = maior taxa (ask em PU),
+        ``taxa_ultima_oferta_venda`` = menor taxa (bid em PU).
     """
     codigos = normalizar_codigos_contrato(codigo_contrato)
     if not codigos:
@@ -278,7 +281,6 @@ def _selecionar_colunas_saida(df: pl.DataFrame) -> pl.DataFrame:
         "numero_negocios",
         "volume_negociado",
         "volume_financeiro",
-        "valor_contrato_ajustado",
         "preco_limite_minimo",
         "preco_limite_maximo",
         "preco_abertura",
@@ -296,8 +298,8 @@ def _selecionar_colunas_saida(df: pl.DataFrame) -> pl.DataFrame:
         "taxa_maxima",
         "taxa_media",
         "taxa_fechamento",
-        "taxa_ultima_oferta_compra",
         "taxa_ultima_oferta_venda",
+        "taxa_ultima_oferta_compra",
         "taxa_ajuste",
         "taxa_forward",
     ]

pyield-0.46.4/pyield/__about__.py

@@ -1 +0,0 @@
-__version__ = "0.46.4"