# 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](https://center.quantis.vzla.io) y el uso se mide por cuenta según un plan.

1. **Crea tu clave de API**

   Entra en [center.quantis.vzla.io](https://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...
   ```

2. **Realiza tu primera solicitud**

   Envía la clave en el encabezado `Authorization`:

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

3. **Lee la respuesta**

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

   ```json
   {
     "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](/es/quantis/v3/me/quota/), debe incluir:

```http
Authorization: Bearer qapi_TU_CLAVE_AQUI
```

Las solicitudes sin una clave válida, o con una clave que revocaste en [center.quantis.vzla.io](https://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](/es/quantis/v3/me/quota/) cuenta 1 solicitud. Cada plan tiene además un límite de solicitudes por segundo. Consulta [Planes y límites](/es/quantis/v3/tiers-and-limits/) para ver cómo funcionan ambos y cómo manejar un `429`.

## Endpoints

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

```json
{
  "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](/es/quantis/v3/holidays/) |
| `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`) |
**Caution:** Las claves v3 son independientes de los tokens v2. Un token v2 `vzlaio_...` no autenticará contra los endpoints v3, y una clave `qapi_...` no funciona en v2. Crea una clave v3 en [center.quantis.vzla.io](https://center.quantis.vzla.io).