{"id":20986356,"url":"https://github.com/mgobeaalcoba/argendolar","last_synced_at":"2025-05-14T17:32:50.042Z","repository":{"id":241562650,"uuid":"807106630","full_name":"Mgobeaalcoba/argendolar","owner":"Mgobeaalcoba","description":"Python package for handling with multiple dollar exchange rate and others currencies","archived":false,"fork":false,"pushed_at":"2024-05-28T16:05:45.000Z","size":62,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-05-29T03:14:17.560Z","etag":null,"topics":["currency-exchange-rates","dolar-blue","dolar-ccl","dolar-cotizacion","dolar-cripto","dolar-mep","euro","pip-package","python-package","python3","real"],"latest_commit_sha":null,"homepage":"","language":"Jupyter Notebook","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/Mgobeaalcoba.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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-05-28T13:48:36.000Z","updated_at":"2024-05-29T03:14:26.525Z","dependencies_parsed_at":"2024-05-29T03:14:24.477Z","dependency_job_id":"c32681ee-5ff1-4f1d-bf41-66427e5085c0","html_url":"https://github.com/Mgobeaalcoba/argendolar","commit_stats":null,"previous_names":["mgobeaalcoba/argendolar"],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Mgobeaalcoba%2Fargendolar","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Mgobeaalcoba%2Fargendolar/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Mgobeaalcoba%2Fargendolar/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Mgobeaalcoba%2Fargendolar/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Mgobeaalcoba","download_url":"https://codeload.github.com/Mgobeaalcoba/argendolar/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":225304013,"owners_count":17453037,"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":["currency-exchange-rates","dolar-blue","dolar-ccl","dolar-cotizacion","dolar-cripto","dolar-mep","euro","pip-package","python-package","python3","real"],"created_at":"2024-11-19T06:13:13.047Z","updated_at":"2024-11-19T06:13:13.667Z","avatar_url":"https://github.com/Mgobeaalcoba.png","language":"Jupyter Notebook","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Argendolar Package\n\n![Visitors](https://api.visitorbadge.io/api/visitors?path=https%3A%2F%2Fgithub.com%2FMgobeaalcoba%2Fargendolar\u0026label=Visitors\u0026countColor=%23263759)\n\n## Description\n\nThis package is used to get the exchange rate between the Argentine Peso and the US Dollar and other currencies (Euro, Real, Peso Chileno y Peso Uruguayo). For this, it uses the [Dolar API](https://dolarapi.com) and the [ArgentinaDatos API](https://argentinadatos.com/docs/) and then it converts the obtained data to a Pandas DataFrame for further analysis.\n\n## Installation\n\nTo install the package, you can use the following command:\n\n```bash\npip install argendolar\n```\n\n## Usage\n\nTo use the package, you can import the `Argendolar` class and create an instance of it. \n \n```python\nfrom argendolar import Argendolar, TipoDivisas\n\n# Create an instance of Argendolar\nargendolar = Argendolar()\n```\n\n## Methods\n\nThe `Argendolar` class has the following methods:\n\n- `api_status()`: Get the status of the API.\n- `get_dolar()`: Get all the dollars exchange rates: official, blue, mep, ccl, tarjeta, mayorista, etc. \n- `get_dolar_chart()`: Get the dollar exchange sales rate for all the dollars: official, blue, mep, ccl, tarjeta, mayorista.\n- `get_oficial()`: Get the official dollar exchange rate.\n- `get_blue()`: Get the blue dollar exchange rate.\n- `get_mep()`: Get the MEP dollar exchange rate.\n- `get_ccl()`: Get the CCL dollar exchange rate.\n- `get_tarjeta()`: Get the dollar exchange rate for credit cards.\n- `get_mayorista()`: Get the dollar exchange rate for wholesale.\n- `get_cripo()`: Get the dollar exchange rate for cripto.\n- `get_euro()`: Get the euro exchange rate.\n- `get_real()`: Get the real exchange rate.\n- `get_chileno()`: Get the peso chileno exchange rate.\n- `get_uruguayo()`: Get the peso uruguayo exchange rate.\n- `get_dolar_historico()`: Get the historical dollar exchange rate for a specific date and Dollar Type (TipoDivisa.OFICIAL, TipoDivisa.BLUE, TipoDivisa.MEP, TipoDivisa.CCL, TipoDivisa.TARJETA, TipoDivisa.MAYORISTA, TipoDivisa.CRIPTO)\n- `get_dolar_historia_completa()`: Get the complete historical dollar exchange rate since 2011.\n- `get_dolar_historia_completa_chart()`: Get the complete historical dollar exchange rate since 2011 in a chart.\n- `get_inflacion_mensual_historica()`: Get the monthly historical inflation rate since 2000-01.\n- `get_inflacion_mensual_historica_chart()`: Get the monthly historical inflation rate since 2000-01 in a chart.\n- `get_inflacion_interanual_historica()`: Get the interannual historical inflation rate since 2000-01.\n- `get_inflacion_interanual_historica_chart()`: Get the interannual historical inflation rate since 2000-01 in a chart.\n- `get_indice_uva_historico()`: Get the historical UVA index since 2016-01.\n- `get_indice_uva_historico_chart()`: Get the historical UVA index since 2016-01 in a chart.\n- `get_tasa_plazo_fijo_diaria_bancos()`: Get the daily fixed term rate for banks.\n- `get_tasa_plazo_fijo_diaria_bancos_chart()`: Get the daily fixed term rate for banks in a chart.\n- `get_tasa_promedio_plazo_fijo_historica()`: Get the historical average fixed term rate since 2000-01.\n- `get_tasa_promedio_plazo_fijo_historica_chart()`: Get the historical average fixed term rate since 2000-01 in a chart.\n\nAll methods initially consult the state of the APIs (`api_status()`) to understand whether or not they can respond to the query. If the API is not active then they return an exception giving visibility to the API crash.\n\n**All methods without the last word chart** return the data in a **Pandas DataFrame** format for a quick and easy analysis or visualization.\n\n**All methods with the last word chart** return the data in a **Matplotlib chart** format for a quick and easy visualization.\n\n## Examples\n\nHere are some examples of how to use the package:\n\n```python\nfrom argendolar import Argendolar\n\n# Create an instance of Argendolar\nargendolar = Argendolar()\n\n# Get the official dollar exchange rate\nofficial = argendolar.get_oficial()\n\n# Get the blue dollar exchange rate\nblue = argendolar.get_blue()\n\n# Get the MEP dollar exchange rate\nmep = argendolar.get_mep()\n\n# Get the CCL dollar exchange rate\nccl = argendolar.get_ccl()\n\n# Get the dollar exchange rate for credit cards\ntarjeta = argendolar.get_tarjeta()\n\n# Get the dollar exchange rate for wholesale\nmayorista = argendolar.get_mayorista()\n\n# Get the dollar exchange rate for cripto\ncripto = argendolar.get_cripo()\n\n# Get the euro exchange rate\neuro = argendolar.get_euro()\n\n# Get the real exchange rate\nreal = argendolar.get_real()\n\n# Get the peso chileno exchange rate\nchileno = argendolar.get_chileno()\n\n# Get the peso uruguayo exchange rate\nuruguayo = argendolar.get_uruguayo()\n\n# Get the historical dollar exchange rate for a specific date\nhistorico = argendolar.get_dolar_historico(tipo: TipoDivisas.MEP, fecha='2022-01-01')\n\n# Get the complete historical dollar exchange rate since 2011\nhistoria_completa = argendolar.get_dolar_historia_completa()\n```\n\n## Contributing\n\nIf you want to contribute to this project, you can follow the steps below:\n\n1. Fork the repository to your own GitHub account.\n2. Clone the repository to your local machine.\n3. Create a new branch for your changes.\n4. Make your changes and commit them.\n5. Push your changes to your forked repository.\n6. Create a pull request from your forked repository to the original repository.\n7. Wait for the review and approval of your pull request.\n8. Once your pull request is approved, your changes will be merged into the main branch of the original repository.\n\n## License\n\nThis project is licensed under the MIT License. See the [LICENSE](LICENSE) file for more details.\n\n## Contact\n\nIf you have any questions or suggestions, you can contact me at [Mariano Gobea Alcoba](mailto:gobeamariano@gmail.com) or [Mariano Gobea Alcoba](https://www.linkedin.com/in/mariano-gobea-alcoba/).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmgobeaalcoba%2Fargendolar","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmgobeaalcoba%2Fargendolar","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmgobeaalcoba%2Fargendolar/lists"}