Market Data en tiempo real

Enviá tu usuario y contraseña de IOL para autenticarte. Es el método más simple.

1{
2  "action": "auth",
3  "username": "tu_usuario",
4  "password": "tu_password"
5}

Usá un token OAuth previamente obtenido desde la REST API. Más seguro para aplicaciones en producción.

1{
2  "action": "auth_token",
3  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
4}

Para mantener la conexión activa, el servidor envía mensajes de ping. Debés responder con pong.

1{
2  "action": "ping"
3}

Cerrá la conexión WebSocket de forma ordenada. El servidor confirmará la desconexión antes de cerrar el socket.

1{
2  "action": "disconnect"
3}

Suscribite a uno o más activos para recibir actualizaciones en tiempo real. Podés combinar múltiples tipos de datos en una sola request.

1{
2  "action": "subscribe",
3  "trades": ["GD30|BCBA|T0"],
4  "quotes": ["ALUA|BCBA|T0", "PAMP|BCBA|T0"]
5}

Cancelá la suscripción a activos específicos cuando ya no necesites recibir sus actualizaciones.

1{
2  "action": "unsubscribe",
3  "quotes": ["CLDR|BCBA|T0"]
4}

Cancelá todas las suscripciones activas de una vez. Útil antes de desconectar o para empezar de cero.

1{
2  "action": "unsubscribe_all"
3}

Cada operación ejecutada en el mercado.

1{
2  "type": "T",
3  "code": 200,
4  "msg": {
5    "S": "GD30",
6    "M": "BCBA",
7    "T": "T0",
8    "P": 28861.0,
9    "X": 5596,
10    "TS": 13654168.0,
11    "TP": 3931492332.82,
12    "D": "2023-10-17T18:39:54.569641+00:00"
13  }
14}

Mejor oferta de compra y venta (BBO).

1{
2  "type": "Q",
3  "code": 200,
4  "msg": {
5    "S": "GD30",
6    "M": "BCBA",
7    "T": "T0",
8    "V": [
9      { "T": "BID", "X": 22006.0, "P": 28861.0 },
10      { "T": "BID", "X": 5720.0, "P": 28860.5 },
11      { "T": "OFFER", "X": 12409.0, "P": 28978.5 }
12    ],
13    "D": "2023-10-17T18:39:57.7727723Z"
14  }
15}

Falta un parámetro requerido o el formato es inválido.

1{
2  "type": "Error",
3  "code": 400,
4  "msg": "Argument Error"
5}

Credenciales inválidas o token expirado.

1{
2  "type": "Error",
3  "code": 401,
4  "msg": "Authentication Error"
5}

No tenés permisos para acceder a este recurso.

1{
2  "type": "Error",
3  "code": 403,
4  "msg": "Forbidden"
5}

El activo solicitado no existe.

1{
2  "type": "Error",
3  "code": 404,
4  "msg": "Not Found"
5}

Demasiadas requests en poco tiempo.

1{
2  "type": "Error",
3  "code": 429,
4  "msg": "Too Many Requests"
5}

Error interno del servidor.

1{
2  "type": "Error",
3  "code": 500,
4  "msg": "Internal Server Error"
5}