API para Desarrolladores
API REST pública y gratuita. Sin autenticación. Consumí cotizaciones del dólar, criptomonedas, índices económicos y más desde tu aplicación.
Formato de respuesta
Todas las respuestas siguen el mismo formato JSON:
Respuesta exitosa
{
"ok": true,
"data": { ... },
"timestamp": "2026-02-23T15:30:00Z"
}Respuesta con error
{
"ok": false,
"error": "Descripción del error",
"timestamp": "2026-02-23T15:30:00Z"
}Base URL
https://www.dolarazo.com.ar/api/v1
Endpoints
Cotizaciones
/api/v1/cotizacionesTodas las cotizaciones disponibles (USD, EUR, BRL).
/api/v1/cotizaciones/dolaresTodos los tipos de dólar en tiempo real.
/api/v1/cotizaciones/dolares/:casaCotización de un tipo específico de dólar.
Parámetros de ruta
| Parámetro | Tipo | Valores |
|---|---|---|
| casa | string | oficial, blue, bolsa, contadoconliqui, mayorista, tarjeta, cripto |
Cotizaciones históricas
/api/v1/cotizaciones/historicas/:casaSerie histórica completa de cotizaciones para un tipo de dólar.
Parámetros de ruta
| Parámetro | Tipo | Valores |
|---|---|---|
| casa | string | oficial, blue, bolsa, contadoconliqui, mayorista, cripto, tarjeta |
Índices económicos
/api/v1/indices/:indiceSerie histórica de un índice económico argentino.
Parámetros de ruta
| Parámetro | Tipo | Valores |
|---|---|---|
| indice | string | inflacion, inflacion-interanual, uva, riesgo-pais, riesgo-pais-ultimo, plazo-fijo |
Criptomonedas
/api/v1/cripto/usdtPrecio de USDT en exchanges argentinos (compra y venta en ARS).
/api/v1/cripto/mercadoTop criptomonedas ordenadas por capitalización de mercado (USD).
Query parameters
| Parámetro | Tipo | Default | Descripción |
|---|---|---|---|
| per_page | number | 50 | Cantidad de resultados (máx. 100) |
| page | number | 1 | Página de resultados |
Brecha cambiaria
/api/v1/brechaBrecha porcentual de cada tipo de dólar respecto al oficial.
Conversor de monedas
/api/v1/conversorEquivalencias ARS/USD con referencias disponibles y fecha del proveedor. No redistribuye tasas internacionales. ARS usa venta en ambos sentidos; MEP/CCL no disponibles. Falta o vencimiento: HTTP 503.
Query parameters
| Parámetro | Tipo | Default | Descripción |
|---|---|---|---|
| monto | number | 1 | Positivo, hasta 1 billón y 6 decimales; sin separadores de miles |
| desde | string | USD | Código moneda origen |
| hasta | string | ARS | Código moneda destino |
| tipo | string | blue | oficial, blue, mayorista, cripto o tarjeta; sujeto a disponibilidad |
Estrategias
/api/v1/momentumSeñal de la estrategia de momentum absoluto sobre CEDEARs: ranking, cartera sugerida, peso por sector y régimen de mercado (SPY vs SMA 10 meses).
Query parameters
| Parámetro | Tipo | Default | Descripción |
|---|---|---|---|
| windows | string | 6,9,12 | Ventanas de retorno en meses, separadas por coma |
| top | number | 10 | Cantidad de posiciones de la cartera |
| cap | number | 0.30 | Peso máximo por sector (0 a 1) |
| skip | number | 1 | Meses recientes que se saltean (convención "12-1") |
| threshold | string | tbill | Umbral de momentum absoluto: tbill (retorno de la T-bill 3 m sobre las mismas ventanas) o cero |
| trend | string | 0 | 1 activa el filtro de tendencia de Faber (SPY < SMA 10 m → cartera en efectivo) |
| capMode | string | cascada | Qué pasa cuando un sector llena el cap: cascada (se completa con otros sectores) o efectivo |
| method | string | promedio | Cómo se combinan los retornos: promedio o mediana |
Estado
/api/v1/estadoEstado de la API, disponibilidad de servicios y horario de mercado.
Códigos de estado HTTP
| Código | Significado |
|---|---|
| 200 | Éxito |
| 400 | Parámetro inválido (tipo de dólar, índice, moneda, etc.) |
| 500 | Error interno o falla en servicio externo |
Cache y límites
- •Cotizaciones en tiempo real: cache de 5 minutos. No hacer polling más frecuente que cada 60 segundos.
- •Datos históricos: cache de 24 horas. Se actualizan una vez al día.
- •Sin rate limiting propio, pero el cache server-side protege contra exceder límites de APIs externas.
- •Consultá
/api/v1/estadopara verificar qué servicios están activos.
Ejemplos de uso
JavaScript / fetch
// Obtener dólar blue
const res = await fetch("https://www.dolarazo.com.ar/api/v1/cotizaciones/dolares/blue");
const { data } = await res.json();
console.log(`Dólar Blue: $${data.venta}`);Python / requests
import requests
r = requests.get("https://www.dolarazo.com.ar/api/v1/cotizaciones/dolares")
data = r.json()["data"]
for d in data:
print(f"{d['nombre']}: {d["venta"]}")cURL
# Convertir 500 USD a ARS usando referencia de venta blue curl "https://www.dolarazo.com.ar/api/v1/conversor?monto=500&desde=USD&hasta=ARS&tipo=blue"