Integrations

The official BCV rate wherever you need it. Everything is free, with no keys and the same data.

The data is published under CC BY 4.0: if you show it, credit the source.

Try it

A minimal example per integration, with today's rate.

curl: JSON API

Request

curl -s https://bcv.today/api/v1/rate.json

Response, trimmed200 · application/json

{
  "USD": 917.7751,
  "EUR": 1007.39583851,
  …
  "effective_date": "2026-11-19"
}

API documentation OpenAPI

Python: bcv library

Install

pip install bcv

Usage

from bcv import BCV

bcv = BCV()
print(bcv.latest()["USD"])  # bolivars per dollar
print(bcv.convert(100, "USD", "VES").result)

Output

917.7751
91777.51

Python guide PyPI

JavaScript: bcv-today library

Install

npm install bcv-today

Usage

import { BCV } from "bcv-today";

const bcv = new BCV();
console.log((await bcv.latest()).rates.USD);  // bolivars per dollar
console.log((await bcv.convert(100, "USD", "VES")).resultText);

Output

917.7751
91777.51

JavaScript guide npm

PHP: grupoclip/bcv-today library

Install

composer require grupoclip/bcv-today

Usage

$bcv = new BcvToday\Bcv();
echo $bcv->latest()->rate('USD'), PHP_EOL;  // bolivars per dollar
echo $bcv->convert('100', 'USD', 'VES')->result;

Output

917.7751
91777.51

Packagist Source code

Odoo: l10n_ve_bcv_rate module

Install

Download it from Odoo Apps, copy it into your addons path, then Apps → search “BCV” → Activate.

Set up

  1. Settings → Accounting → BCV exchange rates
  2. Tick Automatic BCV rates, with the Daily interval
  3. Update now, or wait for the scheduled job

Result

Each company's USD, EUR, CNY, TRY and RUB rates, with the BCV value date as the rate date. Odoo 16–20, Community and Enterprise; not Odoo Online.

View on Odoo Apps Guide

MCP: remote server

Claude Code

claude mcp add --transport http bcv-today https://mcp.bcv.today/mcp

In Claude Desktop and claude.ai: Settings → Connectors → Add custom connector, with the same URL.

Example conversation

You
What is the BCV dollar rate today?
Claude
get_latest_rates The BCV dollar is at 917.7751 bolivars, with value date November 19, 2026.

How to connect it Server card

A2A: Agent2Agent agent

Request

curl -s https://mcp.bcv.today/a2a \
  -H 'Content-Type: application/json' -H 'A2A-Version: 1.0' \
  -d '{"jsonrpc":"2.0","id":1,"method":"SendMessage","params":{"message":{"role":"ROLE_USER","messageId":"1","parts":[{"text":"convert 100 USD to VES"}]}}}'

Response, trimmed200 · application/json

{ "result": { "task": {
  "status": { "state": "TASK_STATE_COMPLETED" },
  "artifacts": [{ "name": "convert", "parts": [
    { "text": "100.00 USD = 91,777.51 VES at the official BCV rate (effective 2026-11-19; …)" },
    { "data": { "result": { "result": 91777.51, "rate": 917.7751 } } }
  ] }]
} } }

How to use it Agent card

Telegram: @BCVTodayBot bot and @bcvtoday channel

Bot

Open @BCVTodayBot in Telegram and send it a command, or just ask: “100 dollars in bolivars”.

Example conversation

You
/dollar
BCV Today
US dollar BCV: 917.7751 Bs. · Effective: November 19, 2026
You
/convert 100 usd
BCV Today
100.00 USD = 91,777.51 Bs.

In any chat (inline mode)

@BCVTodayBot 100 usd

Only want the dollar rate every day? Join the @bcvtoday channel.

Open the bot @bcvtoday channel

All of it is open source: bcv-api (site, API, MCP, A2A, widget and libraries) and odoo-bcv-rate (Odoo module), on GitHub. Missing an integration? Tell us.