Quick Start

sidebar: order: 1

Quantis v2 is a new, richer API surface for Venezuelan exchange-rate data. It uses separate tokens from v1, a new response envelope, and dedicated endpoints per data source.

Create your API token

Open the vzla.io mobile app, go to Settings → API → Generate token. Copy it immediately — the raw token is shown only once.

Tokens look like this:
```
vzlaio_a1b2c3d4e5f6...
```

Make your first request

Pass your token in the Authorization header:

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

Read the response

A successful response wraps data in the {data, meta} envelope:

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

Authentication

Every request (except My Quota) must include:

Authorization: Bearer vzlaio_YOUR_TOKEN_HERE

Requests without a valid token return 401 Unauthorized.

Quota headers

Every response includes these headers so you can track usage without calling /me/quota/:

Header	Description
`X-Quota-Limit`	Your monthly request limit
`X-Quota-Remaining`	Requests remaining this month
`X-Quota-Reset`	ISO 8601 timestamp of next quota reset
`X-Request-ID`	UUID for this request — include when contacting support

Quotas reset on the first day of each calendar month. When you exceed your limit the API returns 429 Too Many Requests.

Endpoints

Endpoint	What it returns	Cache
`GET /api/quantis/v2/rates/bcv/`	Official BCV rates (USD, EUR, CNY, TRY, RUB)	60 min
`GET /api/quantis/v2/rates/markets/`	USDT Binance rate + AVG + DIFF vs BCV	5 min
`GET /api/quantis/v2/rates/banks/`	Per-bank buy/sell/avg rates	30 min
`GET /api/quantis/v2/rates/international/`	~170 world currencies (USD base)	30 min
`GET /api/quantis/v2/rates/crypto/`	USD prices for BTC, ETH, USDT and more	5 min
`GET /api/quantis/v2/holidays/`	Venezuelan bank and public holidays	24 h
`GET /api/quantis/v2/me/quota/`	Your current quota status (free, no quota used)	—

Error format

All errors follow a standard envelope:

{
  "error": {
    "code": "auth_token_unknown",
    "message": "Invalid or inactive token.",
    "details": {}
  }
}

Error code	HTTP status	Meaning
`auth_missing`	401	No `Authorization` header sent
`auth_token_unknown`	401	Token not found or inactive
`quota_exceeded`	429	Monthly limit reached

Complete documentation as plain text for AI tools (llms.txt)