{"id":19574598,"url":"https://github.com/rafpyprog/pysgs","last_synced_at":"2025-04-04T11:07:20.646Z","repository":{"id":47442737,"uuid":"119882857","full_name":"rafpyprog/pySGS","owner":"rafpyprog","description":"📈 Python interface for the Brazilian Central Bank's Time Series Management System (SGS)","archived":false,"fork":false,"pushed_at":"2025-03-22T01:50:03.000Z","size":291,"stargazers_count":76,"open_issues_count":5,"forks_count":21,"subscribers_count":8,"default_branch":"master","last_synced_at":"2025-04-04T10:35:25.230Z","etag":null,"topics":["banco-central-do-brasil","dataset","python","time-series","wrapper-api"],"latest_commit_sha":null,"homepage":"https://pysgs.readthedocs.io","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/rafpyprog.png","metadata":{"files":{"readme":"README.rst","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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-02-01T19:28:19.000Z","updated_at":"2025-03-26T12:44:29.000Z","dependencies_parsed_at":"2025-03-13T03:11:00.384Z","dependency_job_id":"ab43698a-06e7-4739-98b5-47e12e827680","html_url":"https://github.com/rafpyprog/pySGS","commit_stats":null,"previous_names":[],"tags_count":24,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rafpyprog%2FpySGS","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rafpyprog%2FpySGS/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rafpyprog%2FpySGS/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rafpyprog%2FpySGS/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rafpyprog","download_url":"https://codeload.github.com/rafpyprog/pySGS/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247166165,"owners_count":20894654,"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":["banco-central-do-brasil","dataset","python","time-series","wrapper-api"],"created_at":"2024-11-11T06:42:48.942Z","updated_at":"2025-04-04T11:07:20.628Z","avatar_url":"https://github.com/rafpyprog.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":".. image:: https://img.shields.io/pypi/v/sgs.svg\n    :target: https://pypi.org/project/sgs/\n\n.. image:: https://img.shields.io/pypi/l/sgs.svg\n    :target: https://pypi.org/project/sgs/\n\n.. image:: https://img.shields.io/pypi/pyversions/sgs.svg\n    :target: https://pypi.org/project/sgs/\n\n.. image:: https://img.shields.io/pypi/dm/sgs.svg\n    :target: https://pypi.org/project/sgs/\n\n.. image:: https://github.com/rafpyprog/pySGS/actions/workflows/tests.yml/badge.svg\n    :target: https://github.com/rafpyprog/pySGS/actions/workflows/tests.yml\n\n.. image:: https://img.shields.io/codecov/c/github/rafpyprog/pysgs.svg\n    :target: https://codecov.io/github/rafpyprog/pysgs\n    :alt: codecov.io\n\n.. image:: https://img.shields.io/readthedocs/pysgs.svg\n    :target: https://pysgs.readthedocs.io/en/stable/\n    :alt: Read the docs!\n\n|pic 1| **SGS**\n=================\n\n.. |pic 1| image:: https://raw.githubusercontent.com/rafpyprog/sgs/master/icon.png\n\nIntroduction\n------------\n\nThis library provides a pure Python interface for the Brazilian Central Bank's\n`Time Series Management System (SGS) \u003chttps://www.bcb.gov.br/?sgs\u003e`_  api.\nIt works with Python 3.5 and above.\n\nSGS is a service with more than 18,000 time series with economical and financial information.\nThis library is intended to make it easier for Python programmers to use this data in projects of\nany kind, providing mechanisms to search for, extract and join series.\n\n\nQuickstart\n----------\nAccess time series data with **sgs** is very simple\n\nBegin by importing the ``sgs`` module:\n\n\n.. code-block:: python\n\n    import sgs\n\n\nNow, let's try to get a time serie. For this example, let's get the\n\"Interest rate - CDI\" time serie in 2018, wich has the code 12.\n\n\n.. code-block:: python\n\n    CDI_CODE = 12\n    ts = sgs.time_serie(CDI_CODE, start='02/01/2018', end='31/12/2018')\n\n\nNow, we have a Pandas Series object called ``ts``, with all the data and\nthe index representing the dates.\n\n.. code-block:: python\n\n    ts.head()\n\n+------------+----------+\n| 2018-01-02 | 0.026444 |\n+------------+----------+\n| 2018-01-03 | 0.026444 |\n+------------+----------+\n| 2018-01-04 | 0.026444 |\n+------------+----------+\n| 2018-01-05 | 0.026444 |\n+------------+----------+\n| 2018-01-08 | 0.026444 |\n+------------+----------+\n\nFeature Suport\n--------------\n\n* Get time serie data with an one-liner using ``sgs.time_serie``\n* Create a dataframe from a list of time series codes with ``sgs.dataframe``\n* Search time series by text or code with ``sgs.search_ts``\n* Get metadata from all the series in a dataframe using ``sgs.metadata``\n* Support to search and metadata in English and Portuguese\n* Automatic retry\n* Automatic cached requests\n\n\nInstallation\n------------\nTo install, simply use pip:\n\n.. code-block:: bash\n\n    $ pip install sgs\n\nDocumentation\n-------------\n\nComplete documentation is available at https://pysgs.readthedocs.io/en/stable/.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frafpyprog%2Fpysgs","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frafpyprog%2Fpysgs","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frafpyprog%2Fpysgs/lists"}