API para desarrolladores — Tipos de cambio diarios en Chile | Tipo de Cambio Chile

API para desarrolladores — Tipos de cambio diarios en Chile

Esta API te permite consultar el tipo de cambio diario en Chile para una o varias monedas. Si en una fecha no hay dato, se usa automáticamente el último valor disponible anterior a esa fecha (arrastre).

Endpoint


            https://mail.cambista.cl/api/rates_day.php?codes=USD,EUR&date=2025-08-31

Parámetros

codes lista separada por comas de códigos ISO 4217 (ej. USD, EUR, PEN). Requerido.
date fecha YYYY-MM-DD. Opcional, por defecto hoy (zona horaria Chile).
from y to fechas YYYY-MM-DD para un rango de hasta 31 días. Si incluyes estas, se ignora date.

Respuesta

{
  "meta": {
    "tz": "America/Santiago",
    "from": "2025-08-01",
    "to": "2025-08-31",
    "codes": ["USD","EUR"],
    "carried_forward": true
  },
  "data": [
    { "date": "2025-08-30", "rates": { "USD": 965.12, "EUR": 1038.44 } },
    { "date": "2025-08-31", "rates": { "USD": 966.05, "EUR": 1041.02 } }
  ]
}

Ejemplos

Último dato disponible para hoy:

curl "https://mail.cambista.cl/api/rates_day.php?codes=USD,EUR"

Fecha exacta (ayer):

curl "https://mail.cambista.cl/api/rates_day.php?codes=USD&date=2025-11-07"

Rango de 1 mes:

curl "https://mail.cambista.cl/api/rates_day.php?codes=USD,EUR&from=2025-08-01&to=2025-08-31"

Límites y consideraciones

Límite por IP: 100 consultas por día (hora Chile).
Rango máximo: 31 días.
Si una fecha no tiene dato, se aplica arrastre del valor más reciente anterior.
Los valores pueden diferir de bancos o casas de cambio.

Códigos disponibles

Puedes usar los siguientes códigos de monedas en el parámetro codes.

Código	Nombre	País / Región
`ARS`	Peso argentino	Argentina
`AUD`	Dólar australiano	Australia
`BOB`	Boliviano	Bolivia
`BRL`	Real brasileño	Brasil
`CAD`	Dólar canadiense	Canadá
`CHF`	Franco suizo	Suiza
`CNY`	Yuan chino (Renminbi)	China
`COP`	Peso colombiano	Colombia
`EUR`	Euro	Unión Europea
`GBP`	Libra esterlina	Reino Unido
`JPY`	Yen japonés	Japón
`MXN`	Peso mexicano	México
`NZD`	Dólar neozelandés	Nueva Zelanda
`PEN`	Sol peruano	Perú
`PYG`	Guaraní paraguayo	Paraguay
`USD`	Dólar estadounidense	Estados Unidos
`UYU`	Peso uruguayo	Uruguay

Mini SDK en PHP

// sdk.php
class CambistaApi {
  private $base;
  public function __construct($baseUrl) { 
    $this->base = rtrim($baseUrl, '/'); 
  }
  public function ratesDay($codes, $args = []) {
    $params = array_merge(['codes' => implode(',', $codes)], $args);
    $q = [];
    foreach ($params as $k => $v) { 
      if ($v !== '' && $v !== null) 
        $q[] = urlencode($k) . '=' . urlencode($v); 
    }
    $url = $this->base . '/api/rates_day.php' . (count($q) ? '?' . implode('&', $q) : '');
    $ch = curl_init($url);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
    curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 10);
    curl_setopt($ch, CURLOPT_TIMEOUT, 15);
    $out = curl_exec($ch);
    curl_close($ch);
    return $out ? json_decode($out, true) : null;
  }
}

Ejemplo de uso

// ejemplo.php
require 'sdk.php';

// Inicializa con la URL base de tu instalación
$api = new CambistaApi("https://mail.cambista.cl");

// 1) Última tasa USD y EUR de hoy
$res = $api->ratesDay(['USD','EUR']);
print_r($res);

// 2) Consulta de una fecha específica
$res = $api->ratesDay(['USD'], ['date' => '2025-08-31']);
print_r($res);

// 3) Consulta de rango (máx. 31 días)
$res = $api->ratesDay(['USD','EUR'], [
  'from' => '2025-08-01',
  'to'   => '2025-08-31'
]);
print_r($res);