{"id":25343190,"url":"https://github.com/nihey/node-bovespa","last_synced_at":"2025-10-17T20:17:47.172Z","repository":{"id":1107112,"uuid":"41031979","full_name":"nihey/node-bovespa","owner":"nihey","description":"Bovespa data extractor, server, and command line interface","archived":false,"fork":false,"pushed_at":"2023-01-01T05:46:00.000Z","size":796,"stargazers_count":88,"open_issues_count":15,"forks_count":15,"subscribers_count":13,"default_branch":"master","last_synced_at":"2025-01-15T23:17:04.363Z","etag":null,"topics":["bolsa","bovespa","bovespa-api","node-bovespa","stocks","valores"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/nihey.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2015-08-19T12:15:42.000Z","updated_at":"2024-08-07T16:27:31.000Z","dependencies_parsed_at":"2023-01-11T15:49:37.470Z","dependency_job_id":null,"html_url":"https://github.com/nihey/node-bovespa","commit_stats":null,"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nihey%2Fnode-bovespa","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nihey%2Fnode-bovespa/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nihey%2Fnode-bovespa/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nihey%2Fnode-bovespa/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nihey","download_url":"https://codeload.github.com/nihey/node-bovespa/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":238828031,"owners_count":19537603,"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","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":["bolsa","bovespa","bovespa-api","node-bovespa","stocks","valores"],"created_at":"2025-02-14T10:37:46.247Z","updated_at":"2025-10-17T20:17:47.098Z","avatar_url":"https://github.com/nihey.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Node Bovespa\n\n## Warning: This module is currently partially active, due to bovespa's original API disappearance. But it will be brought back to you once we can work around that [issue](https://github.com/nihey/node-bovespa/issues/5).\n\nAccess bovespa/B3 data in many ways:\n\n- API\n- JavaScript module\n\nAlso:\n\n- Scrap and organize data from bovespa's historic time series\n\n[![Dependency\nStatus](https://david-dm.org/nihey/node-bovespa.png)](https://david-dm.org/nihey/node-bovespa)\n[![Build Status](https://travis-ci.org/nihey/node-bovespa.svg?branch=master)](https://travis-ci.org/nihey/node-bovespa)\n\n# Why\n\nFree B3 data extraction is poor, the few places that have it have high costs\nfor starters.\n\nThis project was done so that developers like you and me can have access to B3\ndata in a easier way and develop nice things on top of it.\n\n# Installing\n```bash\n$ npm install bovespa --save\n```\n\nFor CLI usage it would be better to do:\n\n```bash\n$ npm install bovespa -g\n```\n\n# Usage\n\n## JavaScript\n\nWe use the promise API to fetch all sorts of data:\n\n```javascript\n// Using the default API (attention for the final function call):\nconst bovespa = require(\"bovespa\")();\n\n// Querying data:\nbovespa(\"ABEV3\", \"2018-04-23\").then(data =\u003e {\n  // Manipulate your data here\n});\n\n// What is received:\nbovespa(\"ABEV3\", \"2018-04-23\").then(console.log);\n// Outputs raw bovespa data:\n//\n// {\n//   id: 4851343,\n//   day: '2018-04-23',\n//   codbdi: '02',\n//   codneg: 'ABEV3',\n//   tpmerc: '010',\n//   nomres: 'AMBEV S/A',\n//   especi: 'ON',\n//   prazot: '',\n//   modref: 'R$',\n//   preabe: '23.31',\n//   premin: '23.23',\n//   premax: '23.55',\n//   premed: '23.40',\n//   preult: '23.45',\n//   preofc: '23.44',\n//   preofv: '23.45',\n//   preexe: '0.00',\n//   totneg: '21813',\n//   quatot: '8104000',\n//   voltot: '18967719600',\n//   indopc: '0',\n//   fatcot: '0000001',\n//   ptoexe: '0000000000000',\n//   codisi: 'BRABEVACNOR1',\n//   dismes: '119',\n//   datven: '9999-12-31',\n//   created_at: '2019-04-01T12:25:13.439Z',\n//   updated_at: '2019-04-01T12:25:13.439Z'\n// }\n```\n\nThe name of the fields are the same expressed on the ones shown on B3's\nofficial archives. You can have a reference on what they mean by going to\n[this link](http://bvmf.bmfbovespa.com.br/pt-br/download/SeriesHistoricas_Layout.pdf)\n\nYou can use a different server to fetch data from your own API too:\n```javascript\nconst bovespa = require(\"bovespa\")(\"https://\u003cyour own api here\u003e\");\n\nbovespa(\"ABEV3\", \"2018-04-23\").then(data =\u003e {\n  // Manipulate your data here\n});\n```\n\n## CLI\n\nCommand line help should give you a good guide on how to use the project\n\n```bash\n$ bovespa --help\n\n  Bovespa data extractor, server, and command line interface\n\n  Usage:\n    $ bovespa \u003ccodes ...\u003e [Options]\n\n    Extracts data from bovespa and displays it on the terminal\n\n    Options\n      --date, -d \u003cYYYY-MM-DD\u003e [Default: Today] Which date to extract the data from\n      --api, -a \u003cAPI URL\u003e [Default 'https://bovespa.nihey.org']\n\n    Examples:\n      $ bovespa ABEV3\n      $ bovespa ABEV3 --date 2019-04-01\n      $ bovespa ABEV3 PETR4 BIDI4 --date 2019-04-01\n```\n\nYou can query historic time series by using this command:\n\n```bash\n$ bovespa ABEV3 PETR4 -d 2019-04-01\n\n# Output:\n#\n# \u003e CODE: ABEV3 @ 2019-04-01\n# \u003e Variation: -0.30%\n# \u003e Opening: 16.87\n# \u003e Closing: 16.82\n# \u003e Average: 16.85\n# \u003e Max: 17.00\n# \u003e Min: 16.74\n# \u003e\n# \u003e CODE: PETR4 @ 2019-04-01\n# \u003e Variation: -1.43%\n# \u003e Opening: 28.40\n# \u003e Closing: 28.00\n# \u003e Average: 28.11\n# \u003e Max: 28.42\n# \u003e Min: 27.87\n```\n\n# License\n\nThis code is released under\n[CC0](http://creativecommons.org/publicdomain/zero/1.0/) (Public Domain)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnihey%2Fnode-bovespa","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnihey%2Fnode-bovespa","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnihey%2Fnode-bovespa/lists"}