Quick Start

Request an API token

Send an email to 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...
```

Make your first request

Pass your token in the Authorization header:

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

Read the response

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

{
  "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.

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 → for all fields, currencies, and error codes.