OAuth 2.0 + Token

Flujo de autenticación

El mismo token sirve para REST API y WebSocket. Obtenerlo una vez, usarlo en ambos.

Enviá tus credenciales de IOL (las mismas que usás en la app) para obtener un access_token.

import requests

API_URL = "https://api.iolinversiones.com"

# Autenticación
response = requests.post(f"{API_URL}/auth/token", json={
    "grant_type": "password",
    "username": "TU_USUARIO",  # 👈 Mismo de la app IOL
    "password": "TU_PASSWORD"
})

data = response.json()
token = data["data"]["access_token"]
print(f"Token obtenido: {token[:20]}...")

{
  "success": true,
  "data": {
    "access_token": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...",
    "token_type": "bearer",
    "expires_in": 86400,
    "refresh_token": "def50200b9c7f8e..."
  }
}

Incluí el token en el header Authorization de cada request.

GET /broker/accounts HTTP/1.1
Host: api.iolinversiones.com
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...

El mismo token funciona para autenticarte en el WebSocket de market data. Enviá el mensaje de autenticación inmediatamente después de conectar.

{
  "action": "auth_token",
  "token": "eyJhbGciOiJSUzI1NiIs..."
}

{
  "type": "Success",
  "code": 200,
  "msg": "Connected"
}

Los tokens expiran en 24 horas. Usá el refresh_tokenpara obtener uno nuevo sin pedir credenciales de nuevo.

POST /auth/token HTTP/1.1
Host: api.iolinversiones.com
Content-Type: application/json
 
{
  "grant_type": "refresh_token",
  "refresh_token": "def50200b9c7f8e..."
}

Errores comunes