debentures-dot-com 0.1.1__py3-none-any.whl

debentures_dot_com/__consulta_dados.py

@@ -0,0 +1,4 @@
+class UrlDebentures:
+
+    def __init__(self):
+        self.root_url = 'https://www.debentures.com.br/exploreosnd/consultaadados'

debentures_dot_com/__init__.py

@@ -0,0 +1,5 @@
+# src/debentures_dot_com/__init__.py
+from .emissoes import EmissoesDebentures
+from .estoques import EstoquesCorporativos
+from .eventos_fin import EventosFinanceiros
+from .mercados import MercadoSecundario

debentures_dot_com/__volumes.py

@@ -0,0 +1,9 @@
+
+volume/volumeporperiodo_e.asp?op_exc=False&emissao=0&dt_ini=01%2F07%2F2025&dt_fim=23%2F07%2F2025&ICVM=&moeda=1
+volume/volumeporperiodo_e.asp?op_exc=Nada&emissao=2&dt_ini=01%2F07%2F2024&dt_fim=23%2F07%2F2025&ICVM=&moeda=1
+
+/volume/volumeporgarantia-especie_d.asp?pMes_Ini=05&pAno_Ini=2025&pMes_Fim=07&pAno_Fim=2025&moeda=1&pConsol=1&op_exc=Nada&ICVM=%20NULL
+volume/volumeporgarantia-especie_d.asp?pMes_Ini=5&pAno_Ini=2025&pMes_Fim=5&pAno_Fim=2025&pConsol=0&moeda=1&op_exc=Nada&ICVM=%20NULL
+volume/volumeporgarantia-especie_de.asp?pMes_Ini=05&pAno_Ini=2025&pMes_Fim=07&pAno_Fim=2025&moeda=1&pConsol=1&op_exc=Nada&ICVM
+
+https://www.debentures.com.br/exploreosnd/consultaadados/volume/volumeporgarantia-especie_de.asp?pMes_Ini=05&pAno_Ini=2025&pMes_Fim=07&pAno_Fim=2025&moeda=1&pConsol=1&op_exc=Nada&ICVM=%20NULL&ICVM=NULL

debentures_dot_com/emissoes.py

@@ -0,0 +1,175 @@
+import requests
+import io
+import pandas as pd
+from bs4 import BeautifulSoup
+from datetime import date
+from .utils.utils import get_response_to_pd, _format_cnpj, _format_date_for_url
+from .__consulta_dados import UrlDebentures
+
+class EmissoesDebentures:
+    def __init__(self)->str:
+        root_url = UrlDebentures().root_url
+        self.root_url = f'{root_url}/emissoesdedebentures'
+
+    def lista_deb_publicas(self,timeout:int=None)->pd.DataFrame:
+        url = f'{self.root_url}/caracteristicas_r.asp?tip_deb=publicas&op_exc='
+        timeout = timeout if isinstance(timeout,int) else 10
+        r = requests.get(url,timeout=timeout)
+        soup = BeautifulSoup(r.text, 'html.parser')
+        table = soup.find('table', class_='Tab10333333')
+        # Check if the table exists
+        if table:
+            df = []
+            # Extract table rows
+            rows = table.find_all('tr')
+            # Loop through rows and extract data
+            for row in rows:
+                cells = row.find_all(['td', 'th'])  # handles both header and data cells
+                cell_texts = [cell.get_text(strip=True) for cell in cells]
+                df.append(cell_texts[1:-1])
+            df = pd.DataFrame(df, columns = ['Ativo', 'Emissor', 'Dump', 'Situacao'])
+            df = df.drop(columns=['Dump'])
+        else:
+            df = pd.DataFrame()
+            print("Table with class 'Tab10333333' not found.")
+        return df
+    
+    def lista_caracteristicas(self, ativo:str,timeout:int=None)->pd.DataFrame:
+        url = f'{self.root_url}/caracteristicas_e.asp?Ativo={ativo}'
+        timeout = timeout if isinstance(timeout,int) else 10
+        r = requests.get(url,timeout=timeout)
+        df = pd.read_csv(io.StringIO(r.text), sep='|', encoding='utf-8', names=['raw'], skiprows=2)
+        df = df[1:]['raw'].str.split('\t', expand=True).reset_index(drop=True)
+        df = df.T.reset_index(drop=True)
+        df.columns = ['Descricao', 'Valores']
+        return df
+    
+    #def _dt_fim_ini_fix(self, date_):
+    #    dt_par = parser.parse(date_)
+    #    return f'{dt_par.day:02d}%2F{dt_par.month:02d}%2F{dt_par.year}'
+    
+    def pu_historico(self, ativo:str, dt_inicio:str=None, dt_fim:str=None,timeout:int=None)->pd.DataFrame:
+        params = []
+        
+        if not dt_inicio:
+            dt_inicio= '20010101'
+        
+        if not dt_fim:
+            dt_fim = date.today().strftime('%Y%m%d')
+        
+        dt_inicio_fmt = _format_date_for_url(dt_inicio)
+        params.append(f'dt_ini={dt_inicio_fmt}')
+        dt_fim_fmt = _format_date_for_url(dt_fim)
+        params.append(f'dt_fim={dt_fim_fmt}')
+        
+        # Add conditional suffix if any date filters exist
+        add_suffix = '++++' if params else ''
+        
+        query_string = '&' + '&'.join(params) if params else ''
+        url = f'{self.root_url}/puhistorico_e.asp?op_exc=False&ativo={ativo}{add_suffix}{query_string}'
+        
+        return get_response_to_pd(url,timeout=timeout)
+    
+    def prazo_medio(self, ativo:str = None, emissor:str = None, datacvm:str = None, dt_ini:str=None, dt_fim:str=None, anoini:str=None, anofim:str=None, repactuacao:str = None, exec:str = None,timeout:int=None)->list:
+        ativo = ativo if isinstance(ativo, str) else ''
+        emissor = _format_cnpj(emissor) if emissor else ''
+        datacvm = datacvm if isinstance(datacvm, str) else 'e'
+        dt_ini = _format_date_for_url(dt_ini)
+        dt_fim = _format_date_for_url(dt_fim)
+        repactuacao = repactuacao if isinstance(repactuacao, str) else ''
+        exec = exec if isinstance(exec, str) else 'Nada'
+        if isinstance(anoini, int):
+            anoini = str(anoini)
+        elif not isinstance(anoini, str):
+            anoini = ''
+
+        if isinstance(anofim, int):
+            anofim = str(anofim)
+        elif not isinstance(anofim, str):
+            anofim = ''
+        url = (
+            f'{self.root_url}/prazo-medio_e.asp?'
+            f'Ativo={ativo}&Emissor={emissor}&dataCVM={datacvm}&dt_ini={dt_ini}'
+            f'&dt_fim={dt_fim}&anoini={anoini}&anofim={anofim}&ComRepactuacao={repactuacao}&Op_exc={exec}'
+        )
+        df = get_response_to_pd(url,timeout)
+        df_medio = df[:2]
+        df_medio = df_medio.iloc[:, :3]
+        df_medio.columns = ['', 'Tipo Prazo', 'Prazo Medio']
+        df_medio= df_medio.drop(columns='')
+        df_data = df[2:].reset_index(drop=True)
+        df_data.columns = df_data.iloc[0]
+        df_data = df_data[1:].reset_index(drop=True)[:-2]
+        return df_medio, df_data
+
+    def conversao_permuta(self, ativo:str=None, exec:bool=None, dt_ini:str=None, dt_fim:str=None, classe:str=None,timeout:int=None)->pd.DataFrame:
+        ativo = ativo if isinstance(ativo, str) else ''
+        dt_ini = _format_date_for_url(dt_ini)
+        dt_fim = _format_date_for_url(dt_fim)
+        classe = classe if isinstance(classe, str) else ''
+        exec = exec if isinstance(exec, bool) else False
+        url = (
+            f'{self.root_url}/conversoes-permutas_e.asp?'
+            f'ativo={ativo},%20&op_exc={exec}&dt_ini={dt_ini}&dt_fim={dt_fim}&classe={classe}'
+        )
+        return get_response_to_pd(url,timeout=timeout)
+    
+    def caracteristicas_debs(self, tipo:str=None,exec:bool=None,mnome:str=None,ativo:str=None,
+                             ipo:str=None,icvm:str=None,escri_padro:str=None,cvm_ini:str=None,cvm_fim:str=None,
+                             emis_ini:str=None,emis_fim:str=None,venc_ini:str=None,venc_fim:str=None,tpv:str=None,
+                             tnv:str=None,rent_ini:str=None,rent_fim:str=None,distrib_ini:str=None,distrib_fim:str=None,
+                             indice:str=None,tipo_:str=None,crit_calc:str=None,dia_ref:str=None,mult_rend:str=None,
+                             limite:str=None,trat_limite:str=None,tx_spread:str=None,prazo:str=None,premio_novo:str=None,
+                             premio_prazo:str=None,premio_antigo:str=None,par:str=None,amortizacao:str=None,mbanco:str=None,
+                             magente:str=None,instdep:str=None,coordenador:str=None)->pd.DataFrame:
+        tipo = tipo if isinstance(tipo, str) else 'privadas'
+        exec = exec if isinstance(exec, bool) else False
+        mnome = mnome if isinstance(mnome, str) else ''
+        ativo = ativo if isinstance(ativo, str) else ''
+        ipo = ipo if isinstance(ipo, str) else ''
+        icvm = icvm if isinstance(icvm, str) else ''
+        escri_padro = escri_padro if isinstance(escri_padro, str) else ''
+        cvm_ini = cvm_ini if isinstance(cvm_ini, str) else ''
+        cvm_fim = cvm_fim if isinstance(cvm_fim, str) else ''
+        emis_ini = emis_ini if isinstance(emis_ini, str) else ''
+        emis_fim = emis_fim if isinstance(emis_fim, str) else ''
+        venc_ini = venc_ini if isinstance(venc_ini, str) else ''
+        venc_fim = venc_fim if isinstance(venc_fim, str) else ''
+        tpv = tpv if isinstance(tpv, str) else ''
+        tnv = tnv if isinstance(tnv, str) else ''
+        rent_ini = rent_ini if isinstance(rent_ini, str) else ''
+        rent_fim = rent_fim if isinstance(rent_fim, str) else ''
+        distrib_ini = distrib_ini if isinstance(distrib_ini, str) else ''
+        distrib_fim = distrib_fim if isinstance(distrib_fim, str) else ''
+        indice = indice if isinstance(indice, str) else ''
+        tipo_ = tipo_ if isinstance(tipo_, str) else ''
+        crit_calc = crit_calc if isinstance(crit_calc, str) else ''
+        dia_ref = dia_ref if isinstance(dia_ref, str) else ''
+        mult_rend = mult_rend if isinstance(mult_rend, str) else ''
+        limite = limite if isinstance(limite, str) else ''
+        trat_limite = trat_limite if isinstance(trat_limite, str) else ''
+        tx_spread = tx_spread if isinstance(tx_spread, str) else ''
+        prazo = prazo if isinstance(prazo, str) else ''
+        premio_novo = premio_novo if isinstance(premio_novo, str) else ''
+        premio_prazo = premio_prazo if isinstance(premio_prazo, str) else ''
+        premio_antigo = premio_antigo if isinstance(premio_antigo, str) else ''
+        par = par if isinstance(par, str) else ''
+        amortizacao = amortizacao if isinstance(amortizacao, str) else ''
+        mbanco = mbanco if isinstance(mbanco, str) else ''
+        magente = magente if isinstance(magente, str) else ''
+        instdep = instdep if isinstance(instdep, str) else ''
+        coordenador = coordenador if isinstance(coordenador, str) else ''
+
+        url = (
+            f'{self.root_url}/caracteristicas_e.asp?tip_deb={tipo}&'
+            f'op_exc={exec}&mnome={mnome}&ativo={ativo}&IPO={ipo}&icvm={icvm}&EscrituraPadronizada={escri_padro}&'
+            f'cvm_ini={cvm_ini}&cvm_fim={cvm_fim}&emis_ini={emis_ini}&emis_fim={emis_fim}&venc_ini={venc_ini}&venc_fim={venc_fim}&TPV={tpv}&'
+            f'TNV={tnv}&rent_ini={rent_ini}&rent_fim={rent_fim}&distrib_ini={distrib_ini}&distrib_fim={distrib_fim}&indice={indice}&'
+            f'tipo={tipo_}&crit_calc={crit_calc}&dia_ref={dia_ref}&mult_rend={mult_rend}&limite={limite}&trat_limite={trat_limite}&'
+            f'tx_spread={tx_spread}&prazo={prazo}&premio_novo={premio_novo}&premio_prazo={premio_prazo}&premio_antigo={premio_antigo}&Par={par}&'
+            f'amortizacao={amortizacao}&mbanco={mbanco}&magente={magente}&instdep={instdep}&coordenador={coordenador}'
+        )
+        df = get_response_to_pd(url)
+        df.columns = df.iloc[0]
+        df = df[1:].reset_index(drop=True)[:-2]
+        return df

debentures_dot_com/estoques.py

@@ -0,0 +1,177 @@
+import re
+import pandas as pd
+import requests
+from dateutil import parser
+from .utils.utils import get_response_to_pd, _format_cnpj, _format_date_for_url,simple_response_to_pd,get_soup_response_to_pd
+from .__consulta_dados import UrlDebentures
+
+def parse_estoque_data(data_string: str, tipo: str) -> pd.DataFrame:
+    """
+    Parses the given string content into a pandas DataFrame,
+    now also extracting the 'Moeda' type.
+
+    Args:
+        data_string: A string containing the stock data with multiple date blocks.
+
+    Returns:
+        A pandas DataFrame with the extracted stock information.
+    """
+    lines = data_string.strip().split('\n')
+    parsed_data = []
+    current_date = None
+    current_moeda = None # New variable to store the currency type
+
+    for line in lines:
+        line = line.strip()
+
+        # Skip header lines that are not part of the data blocks
+        if line.startswith("Estoque SND Caracter"):
+            continue
+
+        # Extract 'Data do Estoque' and 'Moeda'
+        # Adjusted regex to capture the currency symbol (R$ or US$)
+        date_moeda_match = re.match(r'Data do Estoque (\d{2}/\d{2}/\d{4}) - Moeda (R\$|US\$)', line)
+        if date_moeda_match:
+            current_date = pd.to_datetime(date_moeda_match.group(1), format='%d/%m/%Y')
+            current_moeda = date_moeda_match.group(2) # Capture the currency type
+            continue
+
+        # Identify header row for data blocks
+        if current_date and line.startswith(tipo):
+            headers = [h.strip() for h in line.split('\t') if h.strip()]
+            continue # Move to the next line to read data
+
+        # Read data rows (excluding "Total do dia")
+        if current_date and not line.startswith("Total do dia") and not line.startswith(tipo) and line:
+            parts = [p.strip() for p in line.split('\t') if p.strip()]
+            if parts and len(parts) == len(headers):
+                row_dict = {'Data do Estoque': current_date, 'Moeda': current_moeda} # Add 'Moeda' to the dictionary
+                for i, header in enumerate(headers):
+                    value = parts[i]
+                    # Clean and convert numeric values
+                    if header != tipo:
+                        value = value.replace('.', '').replace(',', '.') # Remove thousands separator, change decimal comma to dot
+                        try:
+                            value = float(value)
+                        except ValueError:
+                            pass # Keep as string if not a number
+                    row_dict[header] = value
+                parsed_data.append(row_dict)
+
+    if not parsed_data:
+        return pd.DataFrame()
+
+    df = pd.DataFrame(parsed_data)
+
+    # Ensure correct column order and data types
+    if not df.empty:
+        df['Data do Estoque'] = pd.to_datetime(df['Data do Estoque'])
+        # Convert numeric columns, handling potential errors if any non-numeric data slipped through
+        for col in ['Mercado', 'Tesouraria', 'Total']:
+            if col in df.columns:
+                df[col] = pd.to_numeric(df[col], errors='coerce')
+    return df
+
+def get_estoque_to_pd(url:str, tipo: str, timeout:int=None)-> pd.DataFrame:
+    timeout = timeout if isinstance(timeout, int) else 10
+    try:
+        response = requests.get(url, timeout=timeout)
+        response.encoding = 'ISO-8859-1'  
+        response.raise_for_status() # Raises HTTPError for bad responses (4xx or 5xx)
+        return parse_estoque_data(response.text, tipo)
+    except requests.exceptions.ConnectionError as e:
+        print(f"Connection Error for {url}: {e}")
+        return pd.DataFrame()
+    except requests.exceptions.Timeout as e:
+        print(f"Timeout Error for {url}: {e}")
+        return pd.DataFrame()
+    except requests.exceptions.HTTPError as e:
+        print(f"HTTP Error for {url}: {e}")
+        return pd.DataFrame()
+    except Exception as e:
+        print(f"An unexpected error occurred for {url}: {e}")
+        return pd.DataFrame()
+
+def _consulta_relatorio(url:str, tipo_relatorio:str, dt_ini:str=None, dt_fim:str=None, moeda:int=None,opcao:int=None,exec:str=None,timeout:int=None)->pd.DataFrame:
+    dt_ini = _format_date_for_url(dt_ini, '%d/%m/%Y') if dt_ini else '02/03/1992'
+    dt_fim = _format_date_for_url(dt_fim,'%d/%m/%Y') if dt_fim else '31/12/2029'
+    if moeda is not None and moeda not in [1, 2]:
+        raise ValueError("Parameter 'moeda' must be 1 or 2.")
+    moeda = moeda if isinstance(moeda, int) else 1
+    exec = exec if isinstance(exec, str) else 'on'
+    opcao = opcao if isinstance(opcao, int) else 100
+    url = (
+        f'{url}/estoquepor_re.asp?op_rel={tipo_relatorio}'
+        f'&Dt_ini={dt_ini}&Dt_fim={dt_fim}&op_exc={exec}&op_subInd=&Opcao={opcao}&Moeda={moeda}'
+    )
+    return get_estoque_to_pd(url, tipo_relatorio, 1000)
+
+class EstoquesCorporativos:
+    """
+        Consult the open data page on debentures.com, 
+        specifically the tab 'estoque' (https://www.debentures.com.br/exploreosnd/consultaadados/estoque/) 
+        to extract the information via Python.
+    """
+
+    def __init__(self)->str:
+        root_url = UrlDebentures().root_url
+        self.root_url = f'{root_url}/estoque'
+
+    def estoque_por_ativo(self, ativo:str=None, dt_ini:str=None, dt_fim:str=None, exec:str=None,moeda:int=None,timeout:int=None)->pd.DataFrame:
+        ativo = ativo if isinstance(ativo, str) else ''
+        exec = exec if isinstance(exec, str) else 'Nada'
+        if moeda is not None and moeda not in [1, 2]:
+            raise ValueError("Parameter 'moeda' must be 1 or 2.")
+        moeda = moeda if isinstance(moeda, int) else 1
+        dt_ini = _format_date_for_url(dt_ini, '%d/%m/%Y') if dt_ini else '02/03/1992'
+        dt_fim = _format_date_for_url(dt_fim, '%d/%m/%Y') if dt_fim else '31/12/2029'
+        url = (
+            f'{self.root_url}/estoqueporativo_e.asp?'
+            f'ativo={ativo}&dt_ini={dt_ini}&dt_fim={dt_fim}&moeda={moeda}&Op_exc={exec}'
+        )
+        if moeda == 1:
+            simb_moeda= 'R$'
+        else:
+            simb_moeda= 'USD'
+        df = get_response_to_pd(url,skiprows=4,timeout=timeout)
+        #df = df.iloc[2:]
+        df.columns = ['Data', 'Qtd Mercado', f'Volume Mercado ({simb_moeda} Mil)','Qtd Tesouraria', 
+                      f'Volume Tesouraria ({simb_moeda} Mil)','Qtd Total', 
+                      f'Volume Total ({simb_moeda} Mil)', 'Dump']
+        df = df.drop(columns=['Dump'])
+        return df
+    
+    def estoque_por_periodo(self, dt_ini:str=None, dt_fim:str=None, moeda:int=None,timeout:int=None)->pd.DataFrame:
+        if moeda is not None and moeda not in [1, 2]:
+            raise ValueError("Parameter 'moeda' must be 1 or 2.")
+        moeda = moeda if isinstance(moeda, int) else 1
+        dt_ini = _format_date_for_url(dt_ini) if dt_ini else '02/03/1992'
+        dt_fim = _format_date_for_url(dt_fim) if dt_fim else '31/12/2029'
+        url = (
+            f'{self.root_url}/estoqueporperiodo_e.asp?'
+            f'dt_ini={dt_ini}&dt_fim={dt_fim}&moeda={moeda}'
+        )
+        df = get_response_to_pd(url,timeout=timeout)
+        return df.iloc[:,:-1]
+    
+    def estoque_a_vencer(self, dt_ini:str=None, dt_fim:str=None, moeda:int=None,repactuacao:int=None,timeout:int=None)->pd.DataFrame:
+        dt_ini = _format_date_for_url(dt_ini) if dt_ini else '02/03/1992'
+        dt_fim = _format_date_for_url(dt_fim) if dt_fim else '31/12/2029'
+        if moeda is not None and moeda not in [1, 2]:
+            raise ValueError("Parameter 'moeda' must be 1 or 2.")
+        moeda = moeda if isinstance(moeda, int) else 1
+        if repactuacao is not None and repactuacao not in [1, 2]:
+            raise ValueError("Parameter 'moeda' must be 1 or 2.")
+        repactuacao = repactuacao if isinstance(repactuacao, int) else 1
+        url = (
+            f'{self.root_url}/estoqueavencer_e.asp?'
+            f'dt_ini={dt_ini}&dt_fim={dt_fim}&moeda={moeda}&rVen={repactuacao}'
+        )
+        df = get_response_to_pd(url,skiprows=4,timeout=timeout)
+        return df.iloc[:,:-1]
+    
+    def estoque_relatorio(self, tipo:str, dt_ini:str=None, dt_fim:str=None, moeda:int=None,opcao:int=None,exec:str=None,timeout:int=None)->pd.DataFrame:
+        if tipo not in ['Indexadores', 'Tipo', 'Forma', 'Classe','Garantia','InstrucaoNormativa']:
+            raise ValueError("Parameter 'tipo' must be 'Indexadores', 'Tipo', 'Forma', 'Classe', 'Garantia' or 'InstrucaoNormativa'")
+        return _consulta_relatorio(self.root_url, tipo, dt_ini, dt_fim, moeda,opcao,exec,timeout)
+

debentures_dot_com/eventos_fin.py

@@ -0,0 +1,37 @@
+from .utils.utils import get_response_to_pd, _format_cnpj, _format_date_for_url
+from .__consulta_dados import UrlDebentures
+
+class EventosFinanceiros:
+    def __init__(self)->str:
+        root_url = UrlDebentures().root_url
+        self.root_url = f'{root_url}/eventosfinanceiros'
+
+    def agenda_eventos(self, ativo:str = None, emissor:str = None, evento:str = None, dt_ini:str=None, dt_fim:str=None, dt_pgto_ini:str=None, dt_pgto_fim:str=None,timeout:int=None)->list:
+        ativo = ativo if isinstance(ativo, str) else ''
+        emissor = _format_cnpj(emissor) if emissor else ''
+        evento = evento if isinstance(evento, str) else ''
+        dt_ini = _format_date_for_url(dt_ini)
+        dt_fim = _format_date_for_url(dt_fim)
+        dt_pgto_ini = _format_date_for_url(dt_pgto_ini)
+        dt_pgto_fim = _format_date_for_url(dt_pgto_fim)
+        url = (
+            f'{self.root_url}/agenda_e.asp?'
+            f'emissor={emissor}&ativo={ativo}&evento={evento}&dt_ini={dt_ini}&dt_fim={dt_fim}'
+            f'&dt_pgto_ini={dt_pgto_ini}&dt_pgto_fim={dt_pgto_fim}'
+        )
+        df = get_response_to_pd(url,timeout=timeout)
+        return df
+    
+    def pu_eventos(self, ativo:str = None, exec:str = None,emissor:str = None, evento:str = None, dt_ini:str=None, dt_fim:str=None,timeout:int=None)->list:
+        ativo = ativo if isinstance(ativo, str) else ''
+        emissor = _format_cnpj(emissor) if emissor else ''
+        exec = exec if isinstance(exec, str) else 'Nada'
+        evento = evento if isinstance(evento, str) else ''
+        dt_ini = _format_date_for_url(dt_ini)
+        dt_fim = _format_date_for_url(dt_fim)
+        url = (
+            f'{self.root_url}/pudeeventos_e.asp?'
+            f'op_exc={exec}&ativo={ativo}&evento={evento}&dt_ini={dt_ini}&dt_fim={dt_fim}&emissor={emissor}'
+        )
+        df = get_response_to_pd(url,timeout=timeout)
+        return df

debentures_dot_com/mercados.py

@@ -0,0 +1,81 @@
+import requests
+import io
+from dateutil import parser
+import pandas as pd
+from .utils.utils import get_response_to_pd, _format_cnpj, _format_date_for_url,simple_response_to_pd,get_soup_response_to_pd
+from .__consulta_dados import UrlDebentures
+
+class MercadoSecundario:
+    def __init__(self)->str:
+        root_url = UrlDebentures().root_url
+        self.root_url = f'https://www.anbima.com.br/informacoes/merc-sec-debentures/'
+        self.root_url_ = f'{root_url}/mercadosecundario'
+
+    def arquivo_precos_diario(self, data:str)->pd.DataFrame:
+        data_ = _format_date_for_url(data, '%y%m%d')
+        url = f'{self.root_url}/arqs/db{data_}.txt'
+        return simple_response_to_pd(url, '@')
+
+    #def vencidos_antecipadamente_diario(self, data:str)->pd.DataFrame:
+    #    data_ = _format_date_for_url(data, '%d%b%Y')
+    #    url = f'{self.root_url}/resultados/mdeb_{data_}_vencidos_antecipadamente.asp'
+    #    df = get_response_to_pd(url)
+    #    return df
+
+    #def ipca_spread_diario(self, data:str)->pd.DataFrame:
+    #    data_ = _format_date_for_url(data, '%d%b%Y')
+    #    url = f'{self.root_url}/resultados/mdeb_{data_}_ipca_spread.asp'
+    #    df = get_response_to_pd(url)
+    #    return df
+    
+    #def igpm_spread_diario(self, data:str)->pd.DataFrame:
+    #    data_ = _format_date_for_url(data, '%d%b%Y')
+    #    url = f'{self.root_url}/resultados/mdeb_{data_}_igp-m.asp'
+    #    df = get_response_to_pd(url)
+    #    return df
+    
+    def preco_negociacao(self, ativo:str = None, exec:str = None,emissor:str = None, dt_ini:str=None, dt_fim:str=None)->list:
+        ativo = ativo if isinstance(ativo, str) else ''
+        emissor = _format_cnpj(emissor) if emissor else ''
+        exec = exec if isinstance(exec, str) else 'Nada'
+        dt_ini = _format_date_for_url(dt_ini, '%Y%m%d') if dt_ini else '19900302'
+        dt_fim = _format_date_for_url(dt_fim, '%Y%m%d') if dt_fim else '20291231'
+        url = (
+            f'{self.root_url_}/precosdenegociacao_e.asp?'
+            f'op_exc={exec}&emissor={emissor}&ativo={ativo}&dt_ini={dt_ini}&dt_fim={dt_fim}'
+        )
+        df = get_response_to_pd(url)
+        return df
+
+    def volume_negociacao(self, dt_ini:str=None, dt_fim:str=None)->list:
+        dt_ini = _format_date_for_url(dt_ini, '%d/%m/%Y') if dt_ini else '02/03/1992'
+        dt_fim = _format_date_for_url(dt_fim, '%d/%m/%Y') if dt_fim else '31/12/2029'
+
+        url = f'{self.root_url_}/volumesnegociados_r.asp'
+
+        headers = {
+            "Host": "www.debentures.com.br",
+            "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:140.0) Gecko/20100101 Firefox/140.0",
+            "Accept": "text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8",
+            "Accept-Language": "en-US,en;q=0.5",
+            "Accept-Encoding": "gzip, deflate, br, zstd",
+            "Content-Type": "application/x-www-form-urlencoded",
+            "Origin": "https://www.debentures.com.br",
+            "Connection": "keep-alive",
+            "Upgrade-Insecure-Requests": "1",
+            "Sec-Fetch-Dest": "document",
+            "Sec-Fetch-Mode": "navigate",
+            "Sec-Fetch-Site": "same-origin",
+            "Sec-Fetch-User": "?1",
+            "DNT": "1",
+            "Sec-GPC": "1",
+            "Priority": "u=0, i",
+        }
+
+        data = {
+            "dt_ini": f"{dt_ini}",
+            "dt_fim": f"{dt_fim}", 
+        }
+
+        df = get_soup_response_to_pd(url, header_class='Ver10666666_cab', table_class='Tab10333333', headers=headers, data=data)
+        return df

debentures_dot_com/utils/utils.py

@@ -0,0 +1,156 @@
+import requests
+import io
+import pandas as pd
+import locale
+from bs4 import BeautifulSoup
+from dateutil import parser
+
+
+def get_response_to_pd(url: str, sep:str = None, headers:dict=None, data:dict=None,timeout:int=None,skiprows:int=None) -> pd.DataFrame:
+    if sep is None:
+        sep = '|'
+    if timeout is None:
+        timeout= 10
+    if skiprows is None:
+        skiprows = 2
+    try:
+        response = requests.get(url, headers=headers, data=data, timeout=timeout)         
+        response.raise_for_status() # Raises HTTPError for bad responses (4xx or 5xx)
+        df = pd.read_csv(io.StringIO(response.text), sep=sep, encoding='utf-8', names=['raw'], skiprows=skiprows)
+        df = df['raw'].str.split('\t', expand=True).reset_index(drop=True)
+        df.columns = df.iloc[0]
+        df = df[1:].reset_index(drop=True)[:-2]
+        return df
+    except requests.exceptions.ConnectionError as e:
+        print(f"Connection Error for {url}: {e}")
+        return pd.DataFrame()
+    except requests.exceptions.Timeout as e:
+        print(f"Timeout Error for {url}: {e}")
+        return pd.DataFrame()
+    except requests.exceptions.HTTPError as e:
+        print(f"HTTP Error for {url}: {e}")
+        return pd.DataFrame()
+    except Exception as e:
+        print(f"An unexpected error occurred for {url}: {e}")
+        return pd.DataFrame()
+    
+def simple_response_to_pd(url:str, sep:str, encoding:str=None, names:list=None, skiprows:int=None) ->pd.DataFrame:
+    encoding = encoding if isinstance(encoding, str) else 'utf-8'
+    names = names if isinstance(names, list) else ['raw']
+    skiprows = skiprows if isinstance(skiprows, int) else 2
+    try:
+        response = requests.get(url, timeout=10)   
+        response.raise_for_status() # Raises HTTPError for bad responses (4xx or 5xx)
+        df = pd.read_csv(io.StringIO(response.text), sep=sep, encoding=encoding, names=names, skiprows=skiprows)
+        return df
+    except requests.exceptions.ConnectionError as e:
+        print(f"Connection Error for {url}: {e}")
+        return pd.DataFrame()
+    except requests.exceptions.Timeout as e:
+        print(f"Timeout Error for {url}: {e}")
+        return pd.DataFrame()
+    except requests.exceptions.HTTPError as e:
+        print(f"HTTP Error for {url}: {e}")
+        return pd.DataFrame()
+    except Exception as e:
+        print(f"An unexpected error occurred for {url}: {e}")
+        return pd.DataFrame()
+
+def _format_cnpj(cnpj: str) -> str:
+    """
+    Formats a CNPJ string to be 14 digits, padding with leading zeros if necessary.
+    Returns an empty string if the input is not a valid CNPJ (e.g., non-numeric or too long).
+    """
+    if not isinstance(cnpj, str):
+        return ''
+    
+    cnpj_digits = ''.join(filter(str.isdigit, cnpj))
+    
+    if len(cnpj_digits) > 14:
+        return '' # CNPJ too long
+    
+    return cnpj_digits.zfill(14)
+
+def _format_date_for_url(date_input: str, dtfmt:str = None, locale_:str = None) -> str:
+    """
+    Converts a date string (in various formats) to DD%2FMM%2FYYYY for URL usage.
+    Returns an empty string if the date cannot be parsed.
+    """
+    if locale_ is None:
+        locale_ = 'pt_BR.utf8'
+    locale.setlocale(locale.LC_TIME, locale_)
+    if dtfmt is None:
+        dtfmt = '%d%%2F%m%%2F%Y'
+    if not isinstance(date_input, str) or not date_input:
+        return ''
+    try:
+        parsed_date = parser.parse(date_input)
+        return parsed_date.strftime(dtfmt)
+    except ValueError:
+        return '' # Invalid date format
+    
+def get_soup_response_to_pd(url: str, header_class:str = None, table_class:str = None, headers:dict=None, data:dict=None,timeout:int=None) ->pd.DataFrame:
+    if timeout is None:
+        timeout= 10
+    try:
+        response = requests.get(url, headers=headers, data=data, timeout=timeout)         
+        response.raise_for_status() # Raises HTTPError for bad responses (4xx or 5xx)
+        soup = BeautifulSoup(response.text, 'html.parser')
+        header_table = soup.find('table', class_=f'{header_class}')
+        headers = []
+        if header_table:
+            header_tds = header_table.find_all('td')
+            for td in header_tds:
+                text = td.get_text(strip=True)
+                if text:
+                    headers.append(text)
+        else:
+            print(f"Could not find the header table (class='{header_class}').")
+            headers = ["Data de Negociação", "Volume Negociado em Moeda da Época"]
+
+        data_table = soup.find('table', class_=f'{table_class}')
+        extracted_data = []
+
+        if data_table:
+            rows = data_table.find_all('tr')
+            for row in rows:
+                cols = row.find_all('td')
+                cols = [ele.get_text(strip=True) for ele in cols]
+                cleaned_row = [col for col in cols if col]
+
+                if cleaned_row:
+                    if "Total:" in cleaned_row[0] or "Total:" in cleaned_row[1]: 
+                        if len(cleaned_row) == 1 and "Total:" in cleaned_row[0]:
+                            total_value_str = cleaned_row[0].replace("Total:", "").strip()
+                            extracted_data.append(["Total", total_value_str])
+                        elif len(cleaned_row) == 2 and "Total:" in cleaned_row[1]:
+                            total_value_str = cleaned_row[1].replace("Total:", "").strip()
+                            extracted_data.append(["Total", total_value_str])
+                        else: 
+                            extracted_data.append(cleaned_row)
+                    elif len(cleaned_row) == 2: 
+                        extracted_data.append(cleaned_row)
+        else:
+            print(f"Could not find the data table (class='{table_class}').")
+        if extracted_data and headers:
+            df = pd.DataFrame(extracted_data, columns=headers)
+            #print("\nDataFrame created successfully:")
+        elif extracted_data:
+            df = pd.DataFrame(extracted_data)
+            print("\nDataFrame created successfully (without specific headers):")
+        else:
+            df = pd.DataFrame()
+            print("No data extracted to form a DataFrame.")
+        return df
+    except requests.exceptions.ConnectionError as e:
+        print(f"Connection Error for {url}: {e}")
+        return pd.DataFrame()
+    except requests.exceptions.Timeout as e:
+        print(f"Timeout Error for {url}: {e}")
+        return pd.DataFrame()
+    except requests.exceptions.HTTPError as e:
+        print(f"HTTP Error for {url}: {e}")
+        return pd.DataFrame()
+    except Exception as e:
+        print(f"An unexpected error occurred for {url}: {e}")
+        return pd.DataFrame()

debentures_dot_com-0.1.1.dist-info/METADATA

@@ -0,0 +1,54 @@
+Metadata-Version: 2.4
+Name: debentures-dot-com
+Version: 0.1.1
+Summary: Um cliente em Python para consultar dados de debêntures do portal debentures.com.br
+Author-email: gtazevedo <guilherme.tt.azevedo@gmail.com>
+Project-URL: Homepage, https://github.com/gtazevedo/debentures_dot_com
+Project-URL: Bug Tracker, https://github.com/gtazevedo/debentures_dot_com/issues
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Office/Business :: Financial
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests
+Requires-Dist: pandas
+Requires-Dist: beautifulsoup4
+Requires-Dist: python-dateutil
+Dynamic: license-file
+
+# debentures_dot_com
+
+API para consultar dados do site [debentures.com.br](https://www.debentures.com.br/).
+
+Esta API está atualmente em sua versão inicial; portanto, algumas funções ainda estão incompletas e nem todos os dados podem ser consultados no momento.
+
+Atualmente, foram adicionadas consultas para os seguintes dados disponíveis na seção [Consulta a Dados](https://www.debentures.com.br/exploreosnd/consultaadados):
+
+- **Emissões Debêntures** (acessível através da classe `EmissoesDebentures`)
+- **Estoques Corporativos** (acessível através da classe `EstoquesCorporativos`)
+- **Eventos Financeiros** (acessível através da classe `EventosFinanceiros`)
+- **Mercado Secundário** (acessível através da classe `MercadoSecundario`)
+
+## Instalação
+O pacote pode ser instalado via pip (exemplo):
+```bash
+pip install debentures-dot-com
+```
+
+## Como Usar
+Um exemplo rápido de como consultar emissões de debêntures públicas:
+
+```python
+from debentures_dot_com import EmissoesDebentures
+
+ed = EmissoesDebentures()
+df = ed.lista_deb_publicas()
+print(df.head())
+```
+
+Para mais detalhes e testes de desenvolvimento, você pode verificar o arquivo `tests/dev.ipynb`.

debentures_dot_com-0.1.1.dist-info/RECORD

@@ -0,0 +1,14 @@
+debentures_dot_com/__consulta_dados.py,sha256=Zl6DnTC1bnImoUVLRAdH2S9Lo7iyKwb8gJ_mVq_-ZWA,133
+debentures_dot_com/__init__.py,sha256=m2TmpzeSfFbkbrJqA99A7VAv94_EHF3RvLLUdImF2To,208
+debentures_dot_com/__volumes.py,sha256=YLcgcBW6D9hKiaPy64e2YSRovaCR3xLSYw90kKvuFeU,827
+debentures_dot_com/emissoes.py,sha256=oEQ-WX8AmsQiasTolLXZYjk6ArhlIfqa6Tb2NZdzLP8,9644
+debentures_dot_com/estoques.py,sha256=RfyzguddQSOQU1uSkZ96sXeQvrZxelfjJltwqx5WNbo,8706
+debentures_dot_com/eventos_fin.py,sha256=vRg7nQ6Iu0u5eM3cDfr5kVAKwHyi299REvt7s1srDGQ,1928
+debentures_dot_com/mercados.py,sha256=ayPBsD2C94Zhn3FMYbHXSjGpz_8ArXjekDksbg17SbA,3630
+debentures_dot_com/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+debentures_dot_com/utils/utils.py,sha256=7onBlgae5nGn1BaMDHC7SkLy8PipRnhWKuKDvtajwaw,6817
+debentures_dot_com-0.1.1.dist-info/licenses/LICENSE,sha256=8BZPj1h3mE1GPJh9yA-zV4yHHm7fmWGKooXqRpmgZBQ,1087
+debentures_dot_com-0.1.1.dist-info/METADATA,sha256=0C1x6XswBcocEaLu2RHh_4poiLz5gMLYOJeozchQoLo,2178
+debentures_dot_com-0.1.1.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+debentures_dot_com-0.1.1.dist-info/top_level.txt,sha256=rsS9-rNuT6I6Lc8ye_foJB-LmFFy5kYd1KPtDrushHs,19
+debentures_dot_com-0.1.1.dist-info/RECORD,,

debentures_dot_com-0.1.1.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

debentures_dot_com-0.1.1.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Guilherme
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

debentures_dot_com-0.1.1.dist-info/top_level.txt

@@ -0,0 +1 @@
+debentures_dot_com