Inicio rápido

1. Solicita un token de API

   Envía un correo a soporte@vzla.io con una breve descripción de lo que estás desarrollando. Recibirás un enlace seguro de un solo uso con tu token — cópialo en un lugar seguro de inmediato, ya que el enlace expira.

   Los tokens tienen este formato:

   gtbe_a1b2c3d4e5f6...

2. Realiza tu primera solicitud

   Incluye tu token en el encabezado Authorization:

   curl --request GET \
     --url 'https://app.vzla.io/api/quantis/v1/rates/' \
     --header 'Authorization: Bearer gtbe_TU_TOKEN_AQUI' \
     --header 'Content-Type: application/json'

3. Lee la respuesta

   Una respuesta exitosa devuelve las tasas de cambio y el estado de tu cuota mensual:

   {
     "USD": {
       "market": "BCV",
       "rate": 92.35,
       "indicator": 1.25,
       "indicator_amount": 1.14,
       "valid_date": "2026-05-01"
     },
     "EUR": { ... },
     "USDT": {
       "market": "Binance",
       "rate": 95.10,
       "timestamp": "2026-05-01T08:40:01.059569Z",
       "indicator": -0.01,
       "indicator_amount": -0.03
     },
     "future_bcv": { ... },
     "quota": {
       "current_usage": 1,
       "monthly_limit": 1000,
       "remaining": 999,
       "reset_at": "2026-05-01T00:00:00Z",
       "next_reset": "2026-06-01T00:00:00Z",
       "subscription_name": "Free Tier"
     }
   }

Autenticación

Cada solicitud debe incluir un Bearer token en el encabezado Authorization:

Authorization: Bearer gtbe_TU_TOKEN_AQUI

Las solicitudes sin un token válido devuelven 401 Unauthorized.

Cuota de uso

Plan	Solicitudes por mes
Free Tier	1.000
De pago	Contáctanos

Las cuotas se reinician el primer día de cada mes calendario — no sobre una ventana de 30 días corridos. Si empiezas a usar la API el 17 de abril, tu contador se reinicia el 1 de mayo.

El objeto quota en cada respuesta muestra tu uso actual y cuándo será el próximo reinicio.

Cuando superas tu límite mensual, la API devuelve 429 Too Many Requests. Para aumentar tu límite, contacta a soporte@vzla.io.

Atribución

Las integraciones del plan gratuito que muestren tasas de cambio a usuarios finales deben indicar a vzla.io como fuente de los datos.

Próximos pasos

Consulta la referencia completa de la API de tasas → para ver todos los campos, monedas y códigos de error.