Package: python-cei-crawler
python-cei-crawlerBiblioteca em python para obtenção de seus dados de investimentos na bolsa de valores (B3/CEI).Esse projeto é altamente influenciado porbolsa. De fato, eu apenas simplifiquei, adicionei e estendi algumas funcionalidades.RequisitosPython 3.8.xInstalação$ pip install python-cei-crawlerUtilizaçãoimportasynciofromcei_crawlerimportCeiCrawlerasyncdefmain():crawler=CeiCrawler(username="CPF/CNPJ",password="Sua senha")assets_extract=awaitcrawler.get_assets_extract()print(assets_extract)# seus ativos negociados no CEIpassive_income_extract=awaitcrawler.get_passive_incomes_extract()print(passive_income_extract)# seus proventos registrados no CEIawaitcrawler.close()if__name__=="__main__":loop=asyncio.get_event_loop()loop.run_until_complete(main())Funções disponíveisAtravés da classe de clientCeiCrawler, você terá acesso as seguintes funções:get_brokersObtém os brokers disponíveis para aquela conta. Retorna uma lista deBroker(Ex: XP Inc, Clear, Easynvest...) com uma lista deBrokerAccount.get_assets_extractObtém uma lista de ativos filtrados pelo parâmetros passados à função. Retorna uma lista deAssetExtract.ParâmetrosAtributoTipoDescriçãobrokersOptional[List[Broker]]Retorna apenas os ativos destes brokersstart_dateOptional[date]Retorna apenas os ativos com data posterior ou igual a esta. Por favor, note que o CEI aceita datas dentro de umrangeespecífico. Se a data passada à função estiver fora, será usado o respectivo valor dorangeinferior.end_dateOptional[date]Retorna apenas os ativos com data inferior ou igual a esta. Por favor, note que o CEI aceita datas dentro de umrangeespecífico. Se a data passada à função estiver fora, será usado o respectivo valor dorangesuperior.as_dictboolRetorna os ativos como dicionários ao invés de objetosAssetExtract. Default:Falseget_passive_incomes_extractObtém uma lista de rendimentos passivos filtrados pelo parâmetros passados à função. Retorna uma lista dePassiveIncome.ParâmetrosAtributoTipoDescriçãodateOptional[date]Retorna apenas os ativos com data posterior ou igual a esta. Por favor, note que o CEI só aceita datas iguais ou 5 dias anteriores ao dia de hoje. Se uma data fora desse intervalo for passado, a consulta será feita com a data de hoje.as_dictboolRetorna os ativos como dicionários ao invés de objetosPassiveIncome. Default:FalseModelsBrokerModel responsável pelos dados do broker.AtributoTipoDescriçãovaluestrIdentificador da corretora na B3.namestrNome do broker na B3.accountsList[BrokerAccount]Lista de contas no broker.BrokerAccountModel responsável pelos dados da conta no broker.AtributoTipoDescriçãoidstrNúmero da conta no broker.AssetExtractModel responsável pelos dados do ativo.AtributoTipoDescriçãooperation_datedatetimeData de operação do ativo.actionAssetExtractActionIdentificador do tipo de operação compra/venda.market_typeAssetExtractMarketTypeTipo de mercado.raw_negotiation_codestrCódigo de negociação.asset_specificationstrEspecificação do ativo no CEI.unit_amountintQuantidade de ativo.unit_priceDecimalValor unitário do ativo.total_priceDecimalValor total do ativo.quotation_factorintFator de cotação.PassiveIncomeModel responsável pelos dados de rendimento passivo.AtributoTipoDescriçãooperation_datedatetimeData do evento.income_typePassiveIncomeTypeTipo de provento (Dividendo, JCP...).event_typePassiveIncomeEventTypeTipo de evento do provento (provisionado, creditado...).raw_negotiation_namestrNome do ativo.raw_negotiation_codestrCódigo de negociação.asset_specificationstrEspecificação do ativo no CEI.unit_amountintQuantidade de ativo.gross_valueDecimalValor bruto do provento.net_valueDecimalValor líquido do provendo.quotation_factorintFator de cotação.