{"id":31897725,"url":"https://github.com/bratergit/brazilstocks","last_synced_at":"2025-10-13T11:44:34.083Z","repository":{"id":317704536,"uuid":"1068502467","full_name":"bratergit/brazilstocks","owner":"bratergit","description":" Brazilian Financial Markets Toolkit","archived":false,"fork":false,"pushed_at":"2025-10-02T13:44:49.000Z","size":9,"stargazers_count":1,"open_issues_count":24,"forks_count":5,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-10-02T15:26:31.461Z","etag":null,"topics":["b3","bovespa","bovespa-stocks","hacktoberfest","hacktoberfest-accepted","stocks","stocks-api"],"latest_commit_sha":null,"homepage":"","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"unlicense","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bratergit.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-10-02T13:35:48.000Z","updated_at":"2025-10-02T15:16:27.000Z","dependencies_parsed_at":null,"dependency_job_id":"c482027b-6c76-40a6-bb41-777acfcca60d","html_url":"https://github.com/bratergit/brazilstocks","commit_stats":null,"previous_names":["bratergit/brazilstocks"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/bratergit/brazilstocks","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bratergit%2Fbrazilstocks","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bratergit%2Fbrazilstocks/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bratergit%2Fbrazilstocks/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bratergit%2Fbrazilstocks/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bratergit","download_url":"https://codeload.github.com/bratergit/brazilstocks/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bratergit%2Fbrazilstocks/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279014811,"owners_count":26085594,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-13T02:00:06.723Z","response_time":61,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["b3","bovespa","bovespa-stocks","hacktoberfest","hacktoberfest-accepted","stocks","stocks-api"],"created_at":"2025-10-13T11:44:31.466Z","updated_at":"2025-10-13T11:44:34.070Z","avatar_url":"https://github.com/bratergit.png","language":null,"readme":"# 📈 Brazilian Financial Markets Toolkit\n\nA Hacktoberfest-friendly open-source project focused on data analysis, quantitative finance, and automated trading strategies for the Brazilian stock market (B3) and cryptocurrencies.\n\n## 🌟 Project Scope\nThis repository aims to be a central hub for tools related to:\n* **Brazilian Stock Market (B3):** Data acquisition, cleaning, and fundamental/technical analysis of Brazilian equities.\n* **Interest Rate Calculation:** Tools for calculating and visualizing common financial metrics and interest rates (e.g., CDI, SELIC, compounded returns).\n* **Web Scraping \u0026 Open Data:** Utilizing open-source data and web scraping techniques to gather non-traditional financial information.\n* **Crypto Trading Bots:** Developing and backtesting automated trading strategies for major cryptocurrencies using Node.js and Python.\n\n## 🛠️ Key Technologies\n| Category | Technology | Purpose |\n| :--- | :--- | :--- |\n| **Data/Analysis** | Python | Primary language for data processing, analysis, and ML. |\n| **Financial Data** | yfinance (Python) | Fetching market data (stocks, ETFs, indices). |\n| **Web Scraping** | Python/Node.js Libraries | Extracting open data from public sources. |\n| **Frontend/Viz** | Streamlit (Python) | Creating interactive dashboards and data visualization tools. |\n| **Automation/Bots** | Node.js | Ideal for building fast, concurrent crypto trading bot components. |\n| **Environment** | Docker / Docker Compose | Ensuring reproducible environments for all contributors. |\n\n## 🖥️ Local Setup\n\nFollow these steps to run the project locally:\n\n1. **Clone the repository**\n```bash\ngit clone https://github.com/bratergit/brazilstocks.git\ncd brazilstocks\n```\n\n2. **Start the environment with Docker Compose**\n```bash\ndocker-compose up\n```\n\n3. Access the app / services\n- If it’s a web service, open your browser at http://localhost:PORT (replace PORT if necessary).\n\n- Tip: Adjust instructions if the project needs any other setup (Python dependencies, Node.js packages, etc.).  \n\n**Step 3: Stage and Commit**\nOnce you save the README changes:\n```bash\ngit add README.md\ngit commit -m \"Add Local Setup section to README with clone and docker-compose instructions\"\n```\n4. **Push the Branch**\n```bash\ngit push origin add-local-setup-readme\n```\n5. **Open a Pull Request**\n- Go to the repo on GitHub.\n- You'll see Compare \u0026 Pull Request for your branch, click it.\n- Title suggestion: \nDocs: Add Local Setup section to README\n- Description suggestion:\nThis PR adds a Local Setup section to README.md for easier onboarding of new contributors. \nInstructions include cloning the repo and running docker-compose.\n- Submit the PR and wait for review.\n\n## 🤝 Contribution Guide\nWe welcome contributions for Hacktoberfest and beyond! Please read the following files to get started:\n* [**CONTRIBUTING.md**](CONTRIBUTING.md) for contribution guidelines and setup.\n* [**CODE_OF_CONDUCT.md**](CODE_OF_CONDUCT.md) for community standards.\n\n## 📝 License\n\nThis project is licensed under the [MIT License](LICENSE) – see the LICENSE file for details.\n\nCheck the [**Issues**](https://github.com/bratergit/stocks/issues) section for tasks labeled **`hacktoberfest`** and **`good first issue`**.\n\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbratergit%2Fbrazilstocks","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbratergit%2Fbrazilstocks","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbratergit%2Fbrazilstocks/lists"}