> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cotizave.com/llms.txt
> Use this file to discover all available pages before exploring further.

# BCV: tasas por banco

> Consulta las tasas de compra y venta por institución y la fecha de cada fila.

`GET /v1/fx/bcv/banks` · Todos los planes. Publica la tabla de compra y venta de USD obtenida del BCV. Es distinta de la tasa oficial agregada `reference`.

<span id="request" />

## Consulta

Devuelve el último snapshot disponible. No requiere parámetros; admite [formatos](/api/formats). La antigua ruta `/v1/beta/fx/bcv/banks` fue retirada.

Los ejemplos se ejecutan en el servidor. JavaScript y Python usan los clientes del [inicio rápido](/api/quickstart#paso-2); configura allí `COTIZAVE_API_KEY`.

<CodeGroup>
  ```bash curl theme={null}
  curl --fail-with-body --max-time 10 "https://api.cotizave.com/v1/fx/bcv/banks" \
    -H "X-API-Key: $COTIZAVE_API_KEY"
  ```

  ```javascript Node.js theme={null}
  import { cotizave } from './cotizave.mjs';

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

  ```python Python theme={null}
  from cotizave import cotizave

  data = cotizave('/v1/fx/bcv/banks')
  print(data)
  ```
</CodeGroup>

<span id="response" />

## Respuesta

Respuesta ilustrativa: las cifras y fechas no son cotizaciones actuales.

```json theme={null}
{
  "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"
}
```

| Campo | Significado |
| - | - |
| `indicator_date` | Fecha de la publicación bancaria principal. |
| `bank_rates[].bank` | Nombre de la institución tal como aparece en la fuente. |
| `buy`, `sell` | Compra y venta de USD, en VES por USD. |
| `date` | Fecha de la publicación a la que pertenece esa fila. |
| `stale` | `true` si la fecha de la fila difiere de `indicator_date`. |
| `days_behind` | Días de retraso respecto a `indicator_date`, mínimo cero. |
| `captured_at` | Momento en que se capturó el snapshot. |

<span id="casos-uso" />

## Comparar bancos

Las filas de la publicación principal aparecen antes que las antiguas. Para comparar una misma jornada filtra `stale === false` y muestra la fecha. No promedies silenciosamente filas de días distintos.

<span id="errores" />

## Errores

`404 bcv_snapshot_unavailable` indica que no hay un snapshot disponible.

Además pueden producirse los [errores comunes](/api/errors) de autenticación, cuota o disponibilidad. Las respuestas de error de la API son JSON; decide por `code`, no por el texto de `message`.

<span id="notas" />

## Frescura por fila

Una captura reciente puede contener filas antiguas. `captured_at` no sustituye `date` ni `stale`. Para la tasa oficial USD/VES usa [reference](/api/endpoints/get-rate-by-market); las columnas de compra y venta de un banco no son esa referencia.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.