Metadata-Version: 2.1
Name: iolConn
Version: 0.2
Summary: Conector python para API de InvertirOnline.
Author-email: "Pedro L. Diego" <diegolpedro@gmail.com>
Project-URL: Homepage, https://github.com/diegolpedro/iolPy
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Classifier: Programming Language :: Python :: 3.7
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE

iolConn - Conector [Invertir Online® API](https://api.invertironline.com/)
=====================================
![PyPI pyversions](https://img.shields.io/badge/python-3.7+-blue.svg?style=flat)
[![Donate](https://img.shields.io/badge/Donate-PayPal-green.svg)](https://paypal.me/diegolpedro)
[![Invitame un cafecito](https://img.shields.io/badge/Donate-PayPal-green.svg)](https://cafecito.app/diegolpedro)

## Descripción
Conector python para API de [InvertirOnline](https://www.invertironline.com). Permite obtener datos de cotizaciones en tiempo real, informacion historica y operar*.

**El ingreso de operaciones no se encuentra al momento disponible.*

Preparación
-----------
### Seteo del entorno
Para utilizar el conector primero preparar un entorno de ejecución. En este caso se utilizó Anaconda y Python 3.7.
```
conda create -n "\<nombre\>" python==3.7
conda activate \<nombre\>
```
Una vez activado el entorno, instalamos los requerimientos.
```
pip3 install -r requirements.txt
```
Utilización
-----------
Puede encontrarse multiples ejemplos de uso dentro del directorio ejemplos. Los mismos traerán desde la API de Iol, la última cotización de Grupo Galicia en el mercado de Buenos Aires, historicos de cotizaciones y paneles completos.
```
python3 example.py
```
Conector
--------
El conector permite gestionar los bearings correspondientes, reutiliza los gestionados y renueva los vencidos. Consta de una clase que debe instanciarse para utilizar las distintas funcionalidades. Las mismas al 31/07/2023 son:
```
gestionar()                                         # Gestion de API tokens.
descargar(solicitud, activo=None)                   # Descargar lotes de cotizaciones.
price_to_json(mercado='bcba', simbolo=None)         # Descargar ultima cotizacion de un simbolo.
hist_price_to_json(mercado='bcba', simbolo=None,    # Descarga de valores temporales para periodo 
                   desde=None, hasta=None)          # particular.
```
### Opciones
Mercados al 08/06/21
- bCBA
- nYSE
- nASDAQ
- aMEX 
- bCS
- rOFX 
### Solicitudes para función descargar
- panelGeneralAcciones  -> Obtenemos cotizaciones de panel general de acciones.
- panelGeneralBonos     -> Obtenemos cotizaciones de panel general de bonos.
- opciones              -> Obtenemos cotizaciones de las distintas bases de opciones de un subyacente x.
### Fechas
- Fechas en formato 2023-07-23

Documentación
-------------
[https://api.invertironline.com/](https://api.invertironline.com/)
