Skip to main content

Biblioteca feita em python com o objetivo de facilitar o acesso a dados de seus investimentos na bolsa de valores(B3/CEI).

Project description

Bolsa - Acesse facilmente seus investimentos na B3/CEI

Biblioteca feita em python com o objetivo de facilitar o acesso a dados de seus investimentos na bolsa de valores(B3/CEI).

image

Requisitos

  • Python 3.8.x

Instalação

$ pip install bolsa

Atualmente implementado usando Asyncio do Python.

Como utilizar

Veja como é simples utilizar:

from bolsa import B3AsyncBackend


b3_httpclient = B3AsyncBackend(
    username='SEU CPF/CNPJ',
    password='SUA SENHA',
    captcha_service=None  # `captcha_service` não é obrigatório ainda
)

brokers = await b3_httpclient.get_brokers_with_accounts()
assets_extract = (
    await b3_httpclient.get_brokers_account_portfolio_assets_extract(
        brokers=brokers
    )
)

print(assets_extract) # Todos os seus ativos consolidados no CEI

await b3_httpclient.session_close()
await b3_httpclient.connection_close()

Você pode acessar exemplos completos clicando aqui.

Funções disponíveis

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

Função Parâmetros Descrição
get_brokers - Obtém os brokers disponíveis para aquela conta. Retorna um objeto Broker. (Ex: XP Inc, Clear, Easynvest...).
get_broker_accounts broker Através de um broker passado como parâmetro, obtém suas respectivas contas na B3. Retorna um Broker com uma lista de BrokerAccount.
get_brokers_with_accounts - É uma junção entre os métodos get_brokers e get_broker_accounts. Retorna uma lista de Broker com uma lista de BrokerAccount.
get_broker_account_portfolio_assets_extract account_id: Número da conta no broker, broker_value: id do broker, broker_parse_extra_data: dados obtidos junto ao broker, account_parse_extra_data: dados obtidos junto a conta na corretora. Utilizado para obter todos os dados de ativos consolidados na b3. Retorna uma lista de BrokerAssetExtract.
get_brokers_account_portfolio_assets_extract brokers Através dos brokers passados por parâmetro, é obtido uma lista de ativos para cada broker. Retorna uma lista de BrokerAssetExtract.

Models

Broker

Model responsável pelos dados do broker.

Atributo Tipo Descrição
value str Identificador da corretora na B3.
name str Nome do broker na B3.
accounts list Lista de contas no broker.

BrokerAccount

Model responsável pelos dados da conta no broker.

Atributo Tipo Descrição
id str Número da conta no broker.

BrokerAssetExtract

Model responsável pelos dados do ativo.

Atributo Tipo Descrição
operation_date datetime Data de operação do ativo.
action BrokerAssetExtractAction Identificador do tipo de operação compra/venda.
market_type BrokerAssetExtractMarketType Tipo de mercado, a vista ou fracionário.
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 total do ativo.
quotation_factor int Fator de cotação.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

bolsa-2.1.0-py3-none-any.whl (11.5 kB view details)

Uploaded Python 3

File details

Details for the file bolsa-2.1.0-py3-none-any.whl.

File metadata

  • Download URL: bolsa-2.1.0-py3-none-any.whl
  • Upload date:
  • Size: 11.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.6.1 requests/2.24.0 setuptools/50.3.0 requests-toolbelt/0.9.1 tqdm/4.51.0 CPython/3.8.2

File hashes

Hashes for bolsa-2.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 e6e36a36b79ce46432ad1e6f39a781e6a6fc8b8001aa9393c4b29d282f8b6ab3
MD5 de37f7d3ed8c538b20de8785ac6b5942
BLAKE2b-256 2dfd1be59755f37081558b655a02205383391ceaa125ac1740a4025eb824a4d7

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page