Documentación Oficial v1.0

Documentación de la API REST

Guía de integración para desarrolladores. Consumí cotizaciones del mercado cambiario en tiempo real con recargos personalizados y latencia ultrabaja.

⚡ Inicio Rápido en 3 Pasos

1

Obtené tu API Key Gratis

Creá tu cuenta gratis en 15 segundos en el Portal de Clientes y obtené 1.000 llamadas/mes al instante.

2

Enviá una petición HTTP GET

Incluí la cabecera HTTP x-api-key: TU_API_KEY en tu solicitud.

3

Procesá el JSON de Respuesta

Recibí cotizaciones finales listas para mostrar en tu web o sistema.

📌 Especificaciones Técnicas

ParámetroValor / Detalle
Endpoint PrincipalGET https://dolarcrypto.io/api/v1/cotizaciones
AutenticaciónHeader x-api-key o Query param ?api_key=
FormatoJSON (UTF-8)
CORSHabilitado para cualquier dominio (Access-Control-Allow-Origin: *)
Frecuencia Caché15 segundos (Costo $0 y respuesta en <20ms)

📥 Estructura de Respuesta JSON (200 OK)

La API retorna un arreglo con los dólares cotizados y las métricas de tu consumo mensual.

{
  "success": true,
  "updatedAt": "2026-07-28T17:15:00.000Z",
  "result": [
    {
      "casa": "blue",
      "nombre": "Dólar Blue",
      "compra": 1450.00,
      "venta": 1480.00
    },
    {
      "casa": "cripto",
      "nombre": "Dólar Cripto",
      "compra": 1758.67,
      "venta": 1761.64
    },
    {
      "casa": "oficial",
      "nombre": "Dólar Oficial",
      "compra": 1050.00,
      "venta": 1090.00
    }
  ],
  "usage": {
    "usedThisMonth": 42,
    "monthlyLimit": 1000,
    "remaining": 958
  }
}

💻 Ejemplos de Código (Copy & Paste)

Elegí tu lenguaje de programación e integralo en tu sistema:

// Integración en JavaScript (Browser o Node.js)
async function getCotizaciones() {
  const API_KEY = 'dkr_live_TU_CLAVE_AQUI';
  
  const res = await fetch('https://dolarcrypto.io/api/v1/cotizaciones', {
    headers: {
      'x-api-key': API_KEY
    }
  });

  const data = await res.json();
  console.log('Cotizaciones Finales:', data.result);
}

getCotizaciones();

🚦 Códigos de Respuesta HTTP

CódigoDescripciónCausa & Solución
200 OKÉxitoPetición procesada correctamente.
401 UnauthorizedSin AutorizaciónFalta la cabecera x-api-key.
403 ForbiddenClave Inválida / Dominio BloqueadoClave incorrecta, suspendida o petición emitida desde un dominio no autorizado.
429 Too Many RequestsLímite ExcedidoSuperaste el límite mensual contratado (ej. 1.000 llamadas en Plan Free). Renovar en el portal.