BCV: rates by bank

GET /v1/fx/bcv/banks · All plans. Returns the USD buy/sell table obtained from BCV. It differs from the aggregate official reference rate.

Request

Returns the latest available snapshot. No parameters required; supports formats. The old /v1/beta/fx/bcv/banks route has been removed. Run these examples on your server. JavaScript and Python use the clients in the quickstart; configure COTIZAVE_API_KEY there.

curl --fail-with-body --max-time 10 "https://api.cotizave.com/v1/fx/bcv/banks" \
  -H "X-API-Key: $COTIZAVE_API_KEY"

import { cotizave } from './cotizave.mjs';

const data = await cotizave('/v1/fx/bcv/banks');
console.log(data);

from cotizave import cotizave

data = cotizave('/v1/fx/bcv/banks')
print(data)

Response

Illustrative response: figures and dates are not current quotes.

{
  "indicator_date": "2026-10-19",
  "bank_rates": [
    {
      "bank": "Banesco",
      "buy": 474.5,
      "sell": 475.5,
      "date": "2026-10-19",
      "stale": false,
      "days_behind": 0
    },
    {
      "bank": "Banco Exterior",
      "buy": 470.5,
      "sell": 471.5,
      "date": "2026-10-16",
      "stale": true,
      "days_behind": 3
    }
  ],
  "captured_at": "2026-10-19T21:00:00Z"
}

Field	Meaning
`indicator_date`	Date of the main bank-rate publication.
`bank_rates[].bank`	Institution name as it appears in the source.
`buy`, `sell`	USD buy and sell quotes, in VES per USD.
`date`	Publication date for that row.
`stale`	`true` when the row date differs from `indicator_date`.
`days_behind`	Days behind `indicator_date`, minimum zero.
`captured_at`	Snapshot capture time.

Compare banks

Rows from the main publication appear before older rows. To compare one publication day, filter stale === false and display the date. Do not silently average rows from different days.

Errors

404 bcv_snapshot_unavailable indicates that no snapshot is available. The common errors for authentication, quota and availability also apply. API error responses are JSON; branch on code, not on the text of message.

Freshness by row

A recent capture may contain older rows. captured_at does not replace date or stale. For the official USD/VES rate, use reference; a bank’s buy and sell columns are not that reference.

Documentation

Get started

API

Venezuela: endpoints

Indices

Guides

BCV: rates by bank

Request

Response

Compare banks

Errors

Freshness by row

​Request

​Response

​Compare banks

​Errors

​Freshness by row

Request

Response

Compare banks

Errors

Freshness by row