Exchange rate

The current value of a currency in bolĂ­vars (Bs). Paths are relative to the /api/v1 prefix; this endpoint is public.

See Common errors. USD is the base currency — see Money representation.

Endpoints

Method URI Role Description
GET /exchange-rate/{code} Public Current rate (in Bs) for a currency code

{code} is a currency code (case-insensitive, e.g. ves, USD).

GET /exchange-rate/{code}

Returns the latest rate for the currency. USD is always available and returns rateBs: 1.0. Any other code must exist and be active. stale flags a rate older than its freshness window.

Response 200

{
  "code": "VES",
  "name": "BolĂ­var",
  "symbol": "Bs",
  "rateBs": 540.04,
  "fetchedAt": "2026-06-26T11:30:00+00:00",
  "stale": false
}

fetchedAt may be null if the rate has never been fetched.

Errors

Status Body When
404 { "error": "NotFound" } Unknown or inactive currency (and not USD)
503 { "error": "ServiceUnavailable", "message": "…" } The rate could not be resolved upstream

Examples

# Current BCV rate for the bolĂ­var
curl /api/v1/exchange-rate/ves

# USD is always 1.0
curl /api/v1/exchange-rate/usd