> ## 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.

# Bank exchange rates by country API

> Use GET /v2/fx/{CC}/bank-rates for available bank rate boards, supported bank filters, and response fields.

`GET /v2/fx/{CC}/bank-rates` returns a bank board where the country publishes one. In Venezuela, `bank` filters by a four-digit bank code.

```bash curl theme={null}
curl "https://api.cotizave.com/v2/fx/VE/bank-rates?bank=0102" \
  -H "X-API-Key: $COTIZAVE_API_KEY"
```

Illustrative response; sample figures and dates:

```json theme={null}
{
  "country": "VE",
  "currency": "VES",
  "indicator_date": "2026-11-03",
  "fetched_at": "2026-11-03T17:05:00Z",
  "captured_at": "2026-11-03T17:05:00Z",
  "plan": "free",
  "banks": [
    {
      "bank": { "code": "0102", "name": "Banco de Venezuela" },
      "base": "USD",
      "quote": "VES",
      "mid": 215.5,
      "bid": 215,
      "ask": 216,
      "updated_at": "2026-11-03T17:00:00Z",
      "stale": false,
      "stale_after_sec": 86400,
      "staleness_sec": 300,
      "days_behind": 0
    }
  ]
}
```

A row is identified by `bank`, not by a rate ID. A country without a board returns `404 bank_rates_not_available`.


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