Necesitas tasas hipotecarias actuales a 2 años que puedas integrar en tu aplicación esta semana. Al final de esta guía, llamarás a un endpoint real que devuelve datos de tasas hipotecarias fijas a 2 años (con proveedores y pagos de ejemplo), los analizarás y enviarás una integración funcional.
Qué obtienes de la API de Tasas Hipotecarias de Canadá
La API de Tasas Hipotecarias de Canadá expone listados de hipotecas a tasa fija por término. Devuelve arreglos estructurados de tasas con el nombre del prestamista/proveedor y un ejemplo de pago periódico. Esto es útil para:
- Widgets de comparación de tasas y páginas de destino que deben mantenerse actualizadas.
- Flujos de pre-calificación donde los usuarios eligen un término y prestamista.
- Distribución de leads y correos electrónicos de alerta de tasas en mercados hipotecarios.
En Zyla API Hub, usas una cuenta, una clave API y un modelo de suscripción y cuota a través de miles de APIs. Para este caso de uso financiero, nos enfocaremos en el endpoint de 2 años y también notaremos las opciones de 3 años y 5 años del mismo listado.
Comenzando en Zyla API Hub
Abre la página del mercado de la API y comienza una prueba para obtener tu clave:
- Visita el listado: Comienza prueba de 7 días en la API de Tasas Hipotecarias de Canadá.
- Haz clic en Suscribirse o Comenzar Prueba Gratuita (cuando esté disponible) y copia tu clave API.
- Autentica con Authorization: Bearer YOUR_API_KEY.
La facturación en Zyla es suscripción + cuota (no pago por llamada). Consulta la página de la API para opciones de acceso y precios actuales.
Endpoints que puedes llamar
Todos los endpoints a continuación son solicitudes POST y, según la documentación, no requieren parámetros de solicitud. Envía solo el encabezado de autorización.
Tasas Hipotecarias a 2 Años
- Método: POST
- URL: https://zylalabs.com/api/5180/canada-mortgage-rates-api/11347/mortgage-rates-2-year
- Descripción: Devuelve una lista de tasas hipotecarias fijas a 2 años con nombres de proveedores y pagos de ejemplo.
Ejemplo de cURL (copiable):
curl -s -X POST "https://zylalabs.com/api/5180/canada-mortgage-rates-api/11347/mortgage-rates-2-year" \
-H "Authorization: Bearer YOUR_API_KEY"
Tasas Hipotecarias a 3 Años
- Método: POST
- URL: https://zylalabs.com/api/5180/canada-mortgage-rates-api/11348/mortgage-rates-3-year
- Descripción: Devuelve una lista de tasas hipotecarias fijas a 3 años con nombres de proveedores y pagos de ejemplo.
Ejemplo de cURL:
Tasas Hipotecarias a 5 Años
- Método: POST
- URL: https://zylalabs.com/api/5180/canada-mortgage-rates-api/11349/mortgage-rates-5-year
- Descripción: Devuelve una lista de tasas hipotecarias fijas a 5 años con nombres de proveedores y pagos de ejemplo.
Ejemplo de cURL:
Forma de respuesta oficial a 2 años
A continuación se muestra el ejemplo oficial para el endpoint de 2 años. Úsalo para dar forma a tus modelos y pruebas.
[
{
"best_2_year_fixed_mortgage_rates": [
{
"rate": "3.99%",
"provider": "Big 6 Bank",
"payment": "$2,077"
},
{
"rate": "4.09%",
"provider": "Scotiabank",
"payment": "$2,098"
},
{
"rate": "4.49%",
"provider": "CanwiseA Ratehub.ca Company",
"payment": "$2,185"
},
{
"rate": "4.49%",
"provider": "Canadian LenderRatehub.ca Exclusive",
"payment": "$2,185"
},
{
"rate": "4.59%",
"provider": "TD Bank",
"payment": "$2,207"
},
{
"rate": "4.64%",
"provider": "MCAP",
"payment": "$2,218"
},
{
"rate": "4.74%",
"provider": "First National",
"payment": "$2,240"
},
{
"rate": "4.79%",
"provider": "RBC Royal Bank",
"payment": "$2,251"
},
{
"rate": "4.84%",
"provider": "National Bank of Canada",
"payment": "$2,263"
},
{
"rate": "4.93%",
"provider": "Bank of Montreal",
"payment": "$2,283"
},
{
"rate": "5.14%",
"provider": "Alterna Savings",
"payment": "$2,330"
},
{
"rate": "5.74%",
"provider": "Meridian Credit Union",
"payment": "$2,468"
},
{
"rate": "7.54%",
"provider": "ICICI Bank Canada",
"payment": "$2,901"
},
{
"rate": "4.49%",
"provider": "CIBC",
"payment": "$2,185"
},
{
"rate": "5.14%",
"provider": "Tangerine",
"payment": "$2,330"
},
{
"rate": "5.74%",
"provider": "Simplii Financial",
"payment": "$2,468"
}
]
}
]
Qué leer:
- best_2_year_fixed_mortgage_rates: arreglo de entradas de tasas para el término de 2 años.
- Cada entrada incluye:
- rate: cadena de porcentaje.
- provider: nombre del prestamista o institución.
- payment: cadena de pago periódico de ejemplo, incluyendo un símbolo de moneda y separadores como se muestra.
Ejemplo en Python: obtener y mostrar las mejores tasas fijas a 2 años
Este script llama al endpoint de 2 años, verifica la carga útil y imprime una lista de comparación simple. Usa solo la URL documentada y el encabezado de autorización.
import os
import requests
API_KEY = os.getenv("ZYLALABS_API_KEY", "YOUR_API_KEY")
URL = "https://zylalabs.com/api/5180/canada-mortgage-rates-api/11347/mortgage-rates-2-year"
headers = {
"Authorization": f"Bearer {API_KEY}"
}
resp = requests.post(URL, headers=headers, timeout=20)
resp.raise_for_status()
data = resp.json()
# Análisis defensivo según el ejemplo oficial
rates = []
if isinstance(data, list) and data:
payload = data[0]
rates = payload.get("best_2_year_fixed_mortgage_rates", [])
# Imprimir una tabla compacta
for item in rates:
provider = item.get("provider")
rate = item.get("rate")
payment = item.get("payment")
print(f"{provider:<30} {rate:>6} {payment:>8}")
Notas de implementación que ahorran tiempo
- Autenticación: Envía Authorization: Bearer YOUR_API_KEY en cada solicitud.
- Cuerpo de solicitud: Ninguno es requerido para estos endpoints; no agregues parámetros adicionales.
- Cadenas y formato: rate y payment se devuelven como cadenas (por ejemplo, "3.99%", "$2,077"). Si necesitas comparaciones numéricas, elimina símbolos y separadores antes de analizar.
- Moneda y cadencia: El valor de pago se presenta como una cadena de moneda formateada. Úsalo para mostrar o deriva números con cuidado; la cadencia (mensual/quincenal) no se especifica en el ejemplo, así que no asumas.
- Actualizaciones y almacenamiento en caché: Si tu UI no requiere frescura de sub-minuto, almacena respuestas del lado del servidor (por ejemplo, durante varios minutos) para reducir llamadas y latencia de página.
- Paginación: No aplicable aquí; la respuesta devuelve un solo arreglo de listados.
- Manejo de errores: Trata los errores no 2xx como fallos transitorios o de autenticación. Registra el cuerpo completo de la respuesta para depuración y presenta una alternativa amigable para el usuario en la UI.
Casos de uso prácticos
- Módulos de página de destino: Muestra “Mejor tasa fija a 2 años hoy” con la línea superior del arreglo, y enlaza a una tabla completa.
- Flujos de pre-aprobación: Permite a los usuarios seleccionar una opción a 2 años de la lista de proveedores; persiste la selección y la instantánea de la tasa en el registro de tu aplicación.
- Distribución de leads: Dirige leads a prestamistas cuyas entradas aparecen en el feed, adjuntando la tasa y las cadenas de pago mostradas.
- Correos electrónicos de alerta de tasas: Compara la mejor tasa a 2 años de hoy con tu línea base almacenada; si la cadena de porcentaje disminuye, activa una notificación.
Expandiendo más allá de los términos a 2 años
Si tu viaje necesita comparaciones de términos lado a lado, llama a los endpoints de 3 años y 5 años y renderiza tablas adyacentes. Dado que estos endpoints comparten el mismo patrón de autenticación y sin parámetros, puedes reutilizar tu código cliente y cambiar solo la URL.
Llama a esta API desde agentes de IA a través de MCP
También puedes invocar APIs de mercado desde agentes de codificación de IA usando el endpoint MCP de Zyla. Apunta tu cliente a https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY y configura una herramienta que publique en la URL del hub deseado. Consulta la página de MCP para detalles sobre cómo integrar esto en tu entorno de desarrollo.
Por qué implementar en Zyla API Hub
- Una clave API y modelo de suscripción a través de más de 10,000 APIs públicas.
- Patrones de autenticación y solicitud consistentes simplifican tu código de backend.
- Agrega más capacidades de finanzas y pagos sin sobrecarga de adquisiciones.
Explora más listados financieros en Zyla API Hub siempre que necesites expandir la superficie de tu producto.
FAQ
¿El endpoint a 2 años requiere algún parámetro?
No. Según la documentación, envía una solicitud POST con solo el encabezado de autorización.
¿Qué campos debo mostrar a los usuarios?
Como mínimo: proveedor, tasa y pago. Mantén el formato de tasa y pago intacto si no necesitas matemáticas numéricas, ya que ya incluyen símbolos y separadores.
¿Con qué frecuencia se actualizan los datos?
La documentación no especifica la frecuencia de actualización. Implementa un almacenamiento en caché que se ajuste a las necesidades de tu UI y verifica el endpoint periódicamente.
¿Hay un plan gratuito?
Los planes en Zyla utilizan suscripción + cuota. Consulta la página de la API para opciones de acceso y precios actuales. Puedes comenzar una prueba de 7 días desde la página del artículo cuando esté disponible.
¿Puedo comparar tasas a 2 años vs 3 años vs 5 años en una sola vista?
Sí. Llama a los tres endpoints de forma independiente y renderiza sus arreglos en tablas o pestañas adyacentes.
¿Listo para construir tu widget de tasas hipotecarias o flujo de incorporación? Comienza tu integración con el endpoint a 2 años hoy: abre el listado de la API de Tasas Hipotecarias de Canadá y comienza la prueba de 7 días.