Skip to main content

Biblioteca em python para obtenção de seus dados deinvestimentos na bolsa de valores (B3/CEI)。

项目描述

python-cei-爬虫

Biblioteca em python para obtenção de seus dados deinvestimentos na bolsa de valores (B3/CEI)。

Esse projeto é altamente influenciado por bolsa。De fato, eu apenas simplifiquei, adicionei e estendi algumas funcionalidades。

要求

  • Python 3.8.x

安装

$ pip install python-cei-crawler

利用率

import asyncio

from cei_crawler import CeiCrawler


async def main():
    crawler = CeiCrawler(username="CPF/CNPJ", password="Sua senha")
    
    assets_extract = await crawler.get_assets_extract()
    print(assets_extract) # seus ativos negociados no CEI

    passive_income_extract = await crawler.get_passive_incomes_extract()
    print(passive_income_extract) # seus proventos registrados no CEI

    await crawler.close()


if __name__ == "__main__":
    loop = asyncio.get_event_loop()
    loop.run_until_complete(main())

Funções disponíveis

Através da classe de client CeiCrawler, você terá acesso as seguintes funções:

get_brokers

Obtém os brokers disponíveis para aquela conta。Retorna uma lista de Broker(Ex: XP Inc, Clear, Easynvest...) com uma lista de BrokerAccount.

get_assets_extract

Obtém uma lista de ativos filtrados pelo parâmetros passados à função。Retorna uma lista de AssetExtract.

参数

属性 蒂波 描述
brokers Optional[List[Broker]] Retorna apenas os ativos destes brokers
start_date Optional[date] Retorna apenas os ativos com 数据在 ou igual a esta 后。请注意 que o CEI aceita datas dentro de um range específico。Se a data passada à função estiver fora, será usado orespectivo valor do range below .
end_date Optional[date] Retorna apenas os ativos com 数据低于 ou igual a esta。请注意 que o CEI aceita datas dentro de um range específico。Se a data passada à função estiver fora, será usado o respectivo valor do range优越。
as_dict bool Retorna os ativos como dicionários ao invés de objetos AssetExtract。默认:False

get_passive_incomes_extract

Obtém uma lista de rendimentos passivos filtrados pelo parâmetros passados à função。Retorna uma lista de PassiveIncome.

参数

属性 蒂波 描述
date Optional[date] Retorna apenas os ativos com 数据在 ou igual a esta 后。请注意 que o CEI só aceita datas iguais ou 5 dias anteriores ao dia de hoje。Se uma data fora desse intervalo for passado, aconsulta será feita com a data de hoje。
as_dict bool Retorna os ativos como dicionários ao invés de objetos PassiveIncome。默认:False

楷模

经纪人

模型 responsável pelos dados 做经纪人。

属性 蒂波 描述
value str Identificador da corretora na B3.
name str Nome do broker na B3。
accounts List[BrokerAccount] Lista de contas 没有经纪人。

经纪人账户

模型responsável pelos dados da conta no broker。

属性 蒂波 描述
id str Número da conta 没有经纪人。

资产提取

模型responsável pelos dados do ativo。

属性 蒂波 描述
operation_date datetime 数据 deoperção do ativo。
action AssetExtractAction Identificador do tipo de operação compra/venda。
market_type AssetExtractMarketType 提示德梅尔卡多。
raw_negotiation_code str Código de negociação。
asset_specification str Especificação do ativo no CEI。
unit_amount int Quantidade de ativo。
unit_price Decimal Valor unitário do ativo。
total_price Decimal Valor 总做 ativo。
quotation_factor int Fator de cotação。

被动收入

模型responsável pelos dados de rendimento passivo。

属性 蒂波 描述
operation_date datetime 数据做eventto。
income_type PassiveIncomeType Tipo deprovento(Dividendo,JCP...)。
event_type PassiveIncomeEventType Tipo de eventto doprovento (provisionado, creditado...)。
raw_negotiation_name str Nome do ativo。
raw_negotiation_code str Código de negociação。
asset_specification str Especificação do ativo no CEI。
unit_amount int Quantidade de ativo。
gross_value Decimal Valor bruto 做证明。
net_value Decimal Valor líquido do provendo。
quotation_factor int Fator de cotação。

项目详情


下载文件

下载适用于您平台的文件。如果您不确定要选择哪个,请了解有关安装包的更多信息。

源分布

python-cei-crawler-0.1.2.tar.gz (15.9 kB 查看哈希

已上传 source

内置分布

python_cei_crawler-0.1.2-py3-none-any.whl (18.3 kB 查看哈希

已上传 py3