# Inicio rápido

1. **Solicita un token de API**

   Envía un correo a [soporte@vzla.io](mailto: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`:

   ```bash
   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:

   ```json
   {
     "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](mailto: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 →](/es/quantis/v1/rates) para ver todos los campos, monedas y códigos de error.