API de Cotizaciones
API REST de Rava Bursatil para consultar precios de acciones, bonos, indices, criptomonedas y mas. Obtene cotizaciones en tiempo real y series historicas con autenticacion simple por Bearer token.
Autenticacion
Todas las solicitudes requieren autenticacion mediante un token Bearer. Inclui tu API Key en el header Authorization de cada request.
Authorization: Bearer <TU_API_KEY>
Ejemplo con cURL
curl -H "Authorization: Bearer TU_API_KEY" \ "https://api5.rava.com/cotizaciones?especie=GGAL"
Endpoint /cotizaciones
Obtene la ultima cotizacion de una o mas especies. Soporta acciones locales, bonos, indices, acciones de EE.UU. y criptomonedas.
/cotizaciones
Parametros
| Parametro | Tipo | Descripcion |
|---|---|---|
especie |
string | Ticker o tickers separados por coma. Ej: GGAL, GGAL,YPFD,MERVAL |
panel |
string | Codigo de panel predefinido. Devuelve todas las especies del panel. Ej: LID, BON, CED. Ver Paneles. |
Debe enviarse especie o panel (al menos uno). | ||
Ejemplos por especie
# Una especie GET /cotizaciones?especie=GGAL # Multiples especies GET /cotizaciones?especie=GGAL,YPFD,MERVAL # Acciones EE.UU. (sufijo _US) GET /cotizaciones?especie=AAPL_US,MSFT_US # Criptomonedas GET /cotizaciones?especie=BTC,ETH,SOL # Indices y tipos de cambio GET /cotizaciones?especie=MERVAL,DOLAR%20MEP,RIESGO%20PAIS
Ejemplos por panel
# Panel Lider (todas las acciones del Merval) GET /cotizaciones?panel=LID # Panel General GET /cotizaciones?panel=GEN # Bonos GET /cotizaciones?panel=BON # CEDEARs GET /cotizaciones?panel=CED # Indices GET /cotizaciones?panel=IND # Criptomonedas GET /cotizaciones?panel=CRIPTO
Respuesta
[
{
"especie": "GGAL",
"fecha": "2025-09-12",
"hora": "17:00:00",
"ultimo": 5840.50,
"variacion": 2.35,
"anterior": 5706.50,
"apertura": 5720.00,
"minimo": 5700.00,
"maximo": 5865.00,
"varMTD": 8.12,
"varYTD": 45.67,
"volumen": 125847320
}
]
Endpoint /historicos
Obtene series historicas de precios para una especie en un rango de fechas.
/historicos
Parametros
| Parametro | Tipo | Descripcion |
|---|---|---|
especie |
string | Ticker de la especie. Ej: GGAL, AAPL_US |
desde |
string | Fecha inicial en formato YYYY-MM-DD |
hasta |
string | Fecha final en formato YYYY-MM-DD |
Ejemplo
GET /historicos?especie=GGAL&desde=2025-08-01&hasta=2025-09-12
Respuesta
[
{
"especie": "GGAL",
"fecha": "2025-08-01",
"ultimo": 5120.00,
"volumen": 98542100
},
{
"especie": "GGAL",
"fecha": "2025-08-02",
"ultimo": 5185.50,
"volumen": 87456200
}
// ...
]
Paneles Disponibles
Los paneles son agrupaciones predefinidas de especies. Usa el parametro panel en /cotizaciones para obtener todas las especies de un grupo en una sola consulta.
| Codigo | Descripcion |
|---|---|
LID | Acciones del Panel Lider (Merval) |
GEN | Acciones del Panel General |
BON | Bonos argentinos |
CED | CEDEARs |
ADRARG | ADRs argentinos en EE.UU. |
GLOBAL | Mercado global (acciones internacionales) |
DOW30 | Las 30 acciones del Dow Jones |
ETF | ETFs internacionales |
CRIPTO | Criptomonedas |
IND | Indices, tipos de cambio y tasas |
Ejemplo
curl -H "Authorization: Bearer TU_API_KEY" \ "https://api5.rava.com/cotizaciones?panel=LID"
Especies Disponibles
La API soporta multiples tipos de instrumentos financieros. A continuacion se detallan los universos disponibles.
Codigos disponibles para consultar indices y tipos de cambio:
Consulta acciones y bonos argentinos usando su ticker. Ejemplos: GGAL, YPFD, PAMP, AL30, GD30, TX26.
La disponibilidad depende del universo cargado en el sistema. Podes descargar el listado completo en la seccion de Descargas.
Las acciones de NYSE y NASDAQ requieren el sufijo _US.
Ejemplos: AAPL_US, MSFT_US, NVDA_US, AMZN_US, GOOGL_US, META_US.
Consulta criptomonedas usando su ticker sin sufijo.
Ejemplos: BTC, ETH, ADA, SOL, DOT, XRP, LTC.
Campos de Respuesta
Descripcion de los campos devueltos por la API.
| Campo | Tipo | Endpoint | Descripcion |
|---|---|---|---|
especie |
string | Ambos | Codigo/ticker consultado |
fecha |
string | Ambos | Fecha de la cotizacion (YYYY-MM-DD) |
hora |
string | /cotizaciones | Hora de la ultima actualizacion (HH:MM:SS) |
ultimo |
number | Ambos | Ultimo precio disponible |
variacion |
number | /cotizaciones | Variacion diaria (% o puntos) |
anterior |
number | /cotizaciones | Precio de cierre anterior |
apertura |
number | /cotizaciones | Precio de apertura del dia |
minimo |
number | /cotizaciones | Precio minimo del dia |
maximo |
number | /cotizaciones | Precio maximo del dia |
varMTD |
number | /cotizaciones | Variacion acumulada del mes |
varYTD |
number | /cotizaciones | Variacion acumulada del ano |
volumen |
number | Ambos | Volumen operado (si aplica) |
Codigos de Error
La API utiliza codigos de estado HTTP estandar para indicar el resultado de las solicitudes.
| Codigo | Estado | Descripcion |
|---|---|---|
| 200 | OK | Solicitud exitosa. Retorna array JSON (puede ser vacio si no hay coincidencias). |
| 400 | Bad Request | Falta el parametro especie o panel, o el panel indicado no existe. |
| 401 | Unauthorized | Falta el header Authorization o la API Key es invalida. |
Recomendaciones de Seguridad
- Usa siempre HTTPS para todas las solicitudes.
- No compartas tu API Key ni la expongas en codigo del lado del cliente.
- Rota tus claves periodicamente.
- Contacta a soporte si sospechas que tu clave fue comprometida.
Descargas
Descarga listados completos de especies disponibles en formato TXT. Requiere autenticacion (usa la API Key del playground).
Probar API
Prueba los endpoints directamente desde esta pagina. Ingresa tu API Key y los parametros deseados.