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-py3-none-any.whl 的哈希值
算法 | 哈希摘要 | |
---|---|---|
SHA256 | 7deb4ecee18f0f37d02ce45005ec5c7d05b4586ef1729064b4af096135574b55 |
|
MD5 | 284ac144dfd6d08665b16602e057c55a |
|
布莱克2-256 | a06c4daa142509e8bc4e120b37a6dd1cad3c5ae0667e0341caf88a8069478c1b |