Inicio rápido

Quantis v3 sirve los mismos datos de tasas de cambio venezolanas que v2, con los mismos endpoints y cuerpos de respuesta. Lo que cambia es cómo obtienes acceso: las claves de API se crean en center.quantis.vzla.io y el uso se mide por cuenta según un plan.

Crea tu clave de API

Entra en center.quantis.vzla.io, regístrate con tu correo y crea una clave. Cópiala de inmediato: la clave en texto plano solo se muestra una vez.

Las claves tienen este formato:
```
qapi_a1b2c3d4e5f6...
```

Realiza tu primera solicitud

Envía la clave en el encabezado Authorization:

curl --request GET \
  --url 'https://app.vzla.io/api/quantis/v3/rates/bcv/' \
  --header 'Authorization: Bearer qapi_TU_CLAVE_AQUI'

Lee la respuesta

Una respuesta exitosa envuelve los datos en el envelope {data, meta}:

{
  "data": {
    "current": {
      "valid_date": "2026-05-06",
      "timestamp": "2026-05-06T09:32:03.108501+00:00",
      "rates": {
        "USD": {
          "rate": "493.37650000",
          "indicator_pct": "0.78066864",
          "indicator_amount": "3.82180000"
        },
        "EUR": { "...": "..." }
      }
    },
    "next": null
  },
  "meta": {
    "source": "BCV",
    "currency_quote": "VES"
  }
}

URL base

https://app.vzla.io/api/quantis/v3/

Autenticación

Cada solicitud, incluida Mi Cuota, debe incluir:

Authorization: Bearer qapi_TU_CLAVE_AQUI

Las solicitudes sin una clave válida, o con una clave que revocaste en center.quantis.vzla.io, devuelven 401 Unauthorized.

Cuota y límite de velocidad

Tu cuota mensual pertenece a tu cuenta y la comparten todas sus claves. Cada llamada excepto Mi Cuota cuenta 1 solicitud. Cada plan tiene además un límite de solicitudes por segundo. Consulta Planes y límites para ver cómo funcionan ambos y cómo manejar un 429.

Endpoints

Endpoint	Qué devuelve	Caché
`GET /api/quantis/v3/rates/bcv/`	Tasas BCV oficiales (USD, EUR, CNY, TRY, RUB)	60 min
`GET /api/quantis/v3/rates/markets/`	Tasa USDT Binance + AVG + DIFF vs BCV	5 min
`GET /api/quantis/v3/rates/banks/`	Tasas compra/venta/promedio por banco	30 min
`GET /api/quantis/v3/rates/international/`	~170 monedas internacionales (base USD)	30 min
`GET /api/quantis/v3/rates/crypto/`	Precios en USD de BTC, ETH, USDT y más	5 min
`GET /api/quantis/v3/rates/history/`	Últimas 30 tasas de cierre diarias	Hasta el fin del día
`GET /api/quantis/v3/holidays/`	Feriados bancarios y nacionales venezolanos	24 h
`GET /api/quantis/v3/me/quota/`	Tu plan y tu uso (sin consumo de cuota)	Ninguna

Formato de errores

Todos los errores siguen un envelope estándar. details solo aparece cuando hay algo que agregar:

{
  "error": {
    "code": "auth_token_unknown",
    "message": "Invalid token format"
  }
}

Código de error	Estado HTTP	Significado
`invalid_parameter`	400	Un parámetro de consulta es inválido, p. ej. `year` o `type` en Feriados
`auth_missing`	401	No se envió el encabezado `Authorization`
`auth_token_unknown`	401	Clave desconocida, mal formada o revocada
`quota_exceeded`	429	La cuota mensual de tu cuenta se agotó. Se reinicia el día 1
`throttled`	429	Demasiadas solicitudes por segundo. Espera los segundos del encabezado `Retry-After` (también en `details.retry_after`)

Documentación completa en texto plano para herramientas de IA (llms.txt)