#Tipo de cambio

Cotizaciones compra/venta por banco de USD y EUR frente al peso mexicano. Son datos de referencia global (no dependen de una Fiscal Entity): cualquier credencial autenticada ve lo mismo. Los montos NUMERIC se serializan como strings (p. ej. "16.55"). Todos los endpoints cuelgan de https://api.clarisfy.com/api/v1/exchange-rates.

La moneda se elige con el query param currency (USD o EUR, por defecto USD); cualquier otra devuelve 400.

#Tipo de cambio de un día

GET/exchange-rates

Cotizaciones de cada banco para una moneda en un día. Si omites date, usa el día más reciente disponible.

Parámetro (query)	Tipo	Descripción
`currency`	string	`USD` o `EUR` (por defecto `USD`).
`date`	string	Día `YYYY-MM-DD`. Por defecto, el más reciente.

curl "https://api.clarisfy.com/api/v1/exchange-rates?currency=USD&date=2026-04-01" \
  -H "Authorization: Bearer clf_live_secret_9K3mZ1pQ7rTx8vB4nH6dLwYe"

{
  "currency": "USD",
  "date": "2026-04-01",
  "source_date": "2026-04-01",
  "rates": [
    { "bank": "BBVA Bancomer", "buy": "16.55", "sell": "17.68" },
    { "bank": "Banxico FIX", "buy": "17.10", "sell": "17.10" }
  ]
}

Campo	Tipo	Descripción
`currency`	string	Moneda consultada.
`date`	string \| null	Día solicitado; `null` si no hay datos en absoluto.
`source_date`	string \| null	Día del que provienen las cotizaciones. Igual a `date` cuando ese día tiene datos; un día anterior (carry-forward) cuando el solicitado cayó en fin de semana, día inhábil o aún no se publica.
`rates`	array	Cotizaciones por banco: `{ bank, buy, sell }` (`buy`/`sell` son strings o `null`).

#Serie histórica de un banco

GET/exchange-rates/series

Serie de tiempo compra/venta de un banco entre from y to (inclusive). Ventana máxima de 24 meses (se recorta el inicio si el rango es mayor). USD tiene histórico; EUR solo acumula hacia adelante.

Parámetro (query)	Tipo	Descripción
`bank`	string	Requerido. Nombre del banco tal cual aparece en el listado.
`currency`	string	`USD` o `EUR` (por defecto `USD`).
`from`	string	Inicio del rango `YYYY-MM-DD`.
`to`	string	Fin del rango `YYYY-MM-DD`. Por defecto, hoy.

curl "https://api.clarisfy.com/api/v1/exchange-rates/series?bank=Banxico%20FIX&currency=USD&from=2026-03-01&to=2026-04-01" \
  -H "Authorization: Bearer clf_live_secret_9K3mZ1pQ7rTx8vB4nH6dLwYe"

{
  "currency": "USD",
  "bank": "Banxico FIX",
  "points": [
    { "date": "2026-03-31", "buy": "17.05", "sell": "17.05" },
    { "date": "2026-04-01", "buy": "17.10", "sell": "17.10" }
  ]
}

Campo	Tipo	Descripción
`currency`	string	Moneda consultada.
`bank`	string	Banco consultado.
`points`	array	Puntos de la serie: `{ date, buy, sell }` (`buy`/`sell` strings o `null`), del más antiguo al más reciente.

400 si la moneda es inválida o from es posterior a to.

#Bancos disponibles

GET/exchange-rates/banks

Los bancos con al menos una cotización para la moneda indicada (para poblar el filtro de la serie histórica).

Parámetro (query)	Tipo	Descripción
`currency`	string	`USD` o `EUR` (por defecto `USD`).

curl "https://api.clarisfy.com/api/v1/exchange-rates/banks?currency=USD" \
  -H "Authorization: Bearer clf_live_secret_9K3mZ1pQ7rTx8vB4nH6dLwYe"

{
  "currency": "USD",
  "banks": ["BBVA Bancomer", "Banxico FIX", "Citibanamex"]
}

Campo	Tipo	Descripción
`currency`	string	Moneda consultada.
`banks`	array	Nombres de banco (strings).