{"id":41366061,"url":"https://github.com/knuppe/openbankingbr","last_synced_at":"2026-01-23T08:26:35.540Z","repository":{"id":38130178,"uuid":"371962035","full_name":"knuppe/openbankingbr","owner":"knuppe","description":"This package is intended to extract public data from the Open Bank Brasil.","archived":false,"fork":false,"pushed_at":"2022-06-23T00:38:26.000Z","size":44,"stargazers_count":18,"open_issues_count":0,"forks_count":4,"subscribers_count":5,"default_branch":"main","last_synced_at":"2025-09-19T19:16:33.268Z","etag":null,"topics":["bacen","banco-central","banco-central-do-brasil","openbanking","openbanking-api","python3"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/knuppe.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2021-05-29T12:01:40.000Z","updated_at":"2025-06-26T19:08:39.000Z","dependencies_parsed_at":"2022-09-16T14:00:41.163Z","dependency_job_id":null,"html_url":"https://github.com/knuppe/openbankingbr","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/knuppe/openbankingbr","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/knuppe%2Fopenbankingbr","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/knuppe%2Fopenbankingbr/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/knuppe%2Fopenbankingbr/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/knuppe%2Fopenbankingbr/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/knuppe","download_url":"https://codeload.github.com/knuppe/openbankingbr/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/knuppe%2Fopenbankingbr/sbom","scorecard":{"id":564951,"data":{"date":"2025-08-11","repo":{"name":"github.com/knuppe/openbankingbr","commit":"3decf9c5802f9626494b5d41f08bf2181f50d5ba"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":2.4,"checks":[{"name":"Pinned-Dependencies","score":-1,"reason":"no dependencies found","details":null,"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#pinned-dependencies"}},{"name":"Code-Review","score":0,"reason":"Found 0/10 approved changesets -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#code-review"}},{"name":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#binary-artifacts"}},{"name":"SAST","score":0,"reason":"no SAST tool detected","details":["Warn: no pull requests merged into dev branch"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}},{"name":"Maintained","score":0,"reason":"0 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"name":"Packaging","score":-1,"reason":"packaging workflow not detected","details":["Warn: no GitHub/GitLab publishing workflow detected."],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#packaging"}},{"name":"Token-Permissions","score":-1,"reason":"No tokens found","details":null,"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#token-permissions"}},{"name":"Dangerous-Workflow","score":-1,"reason":"no workflows found","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#dangerous-workflow"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#cii-best-practices"}},{"name":"Security-Policy","score":0,"reason":"security policy file not detected","details":["Warn: no security policy file detected","Warn: no security file to analyze","Warn: no security file to analyze","Warn: no security file to analyze"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#security-policy"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#fuzzing"}},{"name":"License","score":10,"reason":"license file detected","details":["Info: project has a license file: LICENSE:0","Info: FSF or OSI recognized license: MIT License: LICENSE:0"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"name":"Signed-Releases","score":-1,"reason":"no releases found","details":null,"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}},{"name":"Branch-Protection","score":0,"reason":"branch protection not enabled on development/release branches","details":["Warn: branch protection not enabled for branch 'main'"],"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#branch-protection"}},{"name":"Vulnerabilities","score":5,"reason":"5 existing vulnerabilities detected","details":["Warn: Project is vulnerable to: PYSEC-2014-14 / GHSA-652x-xj99-gmcc","Warn: Project is vulnerable to: GHSA-9hjg-9r4m-mvj7","Warn: Project is vulnerable to: GHSA-9wx4-h78v-vm56","Warn: Project is vulnerable to: PYSEC-2014-13 / GHSA-cfj3-7x9c-4p3h","Warn: Project is vulnerable to: PYSEC-2018-28 / GHSA-x84v-xcm2-53pg"],"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}}]},"last_synced_at":"2025-08-20T14:43:32.952Z","repository_id":38130178,"created_at":"2025-08-20T14:43:32.952Z","updated_at":"2025-08-20T14:43:32.952Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28684538,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-23T05:48:07.525Z","status":"ssl_error","status_checked_at":"2026-01-23T05:48:07.129Z","response_time":59,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bacen","banco-central","banco-central-do-brasil","openbanking","openbanking-api","python3"],"created_at":"2026-01-23T08:26:32.041Z","updated_at":"2026-01-23T08:26:35.535Z","avatar_url":"https://github.com/knuppe.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# OpenBankingBR\n\nUm pacote Python para carregar, analisar e exportar os **dados públicos** expostos pelos participantes do [OpenBanking Brasil](https://openbankingbrasil.org.br/).\n\n\u003e This package is intended to extract public data from the Open Bank Brasil. Since most users of this library will be Brazilians, everything is in Portuguese. \n\nDados suportados:\n\n**Participantes**\n\n**Agências** via `/open-banking/channels/v1/branches`\n```python\nfrom openbankingbr import OpenBankingBR\n\nob = OpenBankingBR(cacheDir='./cache')\n\nfor participante in ob.participantes:\n    for agencia in participante.agencias:\n        print(f'Participante: {participante.nome} \u003e agencia código: {agencia.codigo}')\n\n```\n\n**Produtos** via `/open-banking/products-services/v1/*`\n```python\nfrom openbankingbr import OpenBankingBR\n\nob = OpenBankingBR(cacheDir='./cache')\n\nfor participante in ob.participantes:\n    print(f'Participante: {participante.nome}')\n    for produto in participante.produtos:\n        print(f'Produto: {produto.tipo} - {produto.nome}')\n    \n        # Serviços disponíveis no produto\n        for servico in produto.servicos:\n            print(f'    Serviço \u003e {servico.nome}')\n        \n        # Pacotes de serviço disponíveis no produto.\n        for pacote in produto.pacotes:\n            print(f'    Pacote \u003e {pacote.nome}')\n\n```\n\n## Mecanismo de cache\n\nComo esta biblioteca realiza centenas de chamadas em API's das financeiras, existe um mecanimo padrão de salvar os dados retornados pelos end-points das apis em uma pasta de cache com o objetivo de não enviar um request bem sucedido mais de uma vez no mesmo dia para a endpoint/financeira.\n\nBasicamente é um mecanismo de bom senso para não abusar das apis disponibilizadas pelas financeiras, porém você pode desabilitar este comportamento com `cacheDir = None` (mas não recomendo).\n\n## Processamento batch\n\nO objetivo inicial ao criar este pacote foi exportar os dados que são listados pelos participantes periodicamente para realizar análises dos produtos de crédito das instituições financeiras.\n\nUma forma simples de exportar todos produtos listados:\n\n```python\nfrom openbankingbr.batch import BatchOpenBanking\nbatch = BatchOpenBanking(\n    dataDir  = './data' ,\n    cacheDir = './cache',\n    ignoraErros = True  ,  \n)\nbatch.todos_dados()\n#\n# ou... somente os aquivos que interessar.\n#\n# batch.agencias_csv()\n# batch.produtos_csv()\n# batch.servicos_csv()\n# batch.pacotes_csv()\n\n```\n\n## Notas importantes\n### Qualidade dos dados\n\n\u003e Em teoria as APIs são homologadas pelo Bacen, porém na prática consultando as APIs é facilmente observado que **várias** instituições financeiras não seguem o padrão da documentação, não sei como passaram na homologação, mas o fato é que o dado problemático existe. Nesta biblioteca tentei contornar e validar o máximo dos dados, ignorando os valores que são absurdamente fora do [padrão](https://openbanking-brasil.github.io/areadesenvolvedor/) da documentação.\n\n### Segurança\n\n\u003e A validação de certificados SSL teve que ser desabilitada, visto que as financeiras Brasileiras não se dão ao trabalho de ter um certificado SSL válido para as APIs expostas para a internet.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fknuppe%2Fopenbankingbr","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fknuppe%2Fopenbankingbr","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fknuppe%2Fopenbankingbr/lists"}