# Quick Start

sidebar:
  order: 1

1. **Request an API token**

   Send an email to [soporte@vzla.io](mailto:soporte@vzla.io) with a brief description of what you're building. You'll receive a secure one-time link with your token — copy it to a safe place immediately, as the link expires.

   Tokens look like this:

   ```
   gtbe_a1b2c3d4e5f6...
   ```

2. **Make your first request**

   Pass your token in the `Authorization` header:

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

3. **Read the response**

   A successful response returns exchange rates and your current quota usage:

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

## Authentication

Every request must include a Bearer token in the `Authorization` header:

```
Authorization: Bearer gtbe_YOUR_TOKEN_HERE
```

Requests without a valid token return `401 Unauthorized`.

## Usage quota

| Plan | Requests per month |
|---|---|
| Free Tier | 1,000 |
| Paid | Contact us |

Quotas reset on the **first day of each calendar month** — not on a rolling 30-day basis. If you start using the API on April 17, your counter resets on May 1.

The `quota` object in every response shows your current usage and when the next reset is scheduled.

When you exceed your monthly limit the API returns `429 Too Many Requests`. For higher limits, contact [soporte@vzla.io](mailto:soporte@vzla.io).

## Attribution

Free-tier integrations that display exchange rates to end users should credit **vzla.io** as the data source.

## Next steps

See the full [Rates API reference →](/quantis/v1/rates) for all fields, currencies, and error codes.