Documentación API

Primeros Pasos

Nuestra API te permite acceder a las tasas oficiales del BCV de forma rápida y confiable.

Tasas de Dólar, Euro y USDT

Consulta la tasa oficial del BCV (dólar y euro) y la tasa de USDT/VES (promedio Binance P2P). Los límites de consultas y las monedas disponibles dependen del plan activo de tu cuenta: consulta tu panel de usuario o la sección de planes para ver los detalles actuales.

Request

GET https://bcvapi.cc/api/v1/dolar
Headers:
Authorization: tu_api_key_aqui

Response

{
  "tasa": 787.52,
  "fuente": "https://www.bcv.org.ve/",
  "fecha": "2026-08-26",
  "registrado": true
}

La respuesta de /api/v1/euro y /api/v1/usdt tiene exactamente el mismo formato, con la tasa de esa moneda.

Plan gratuito — endpoint del dólar

Los límites de consultas y monedas disponibles dependen del plan activo de tu cuenta. El plan Gratuito incluye acceso al endpoint del dólar con un límite de 50 consultas mensuales. Consulta la sección de planes o tu dashboard para el detalle actualizado.

Las variantes /api/v1/dolar/public, /api/v1/euro/public y /api/v1/usdt/public existen únicamente como respaldo de baja demanda para la calculadora integrada del sitio y no están pensadas para integraciones externas; para cualquier integración, app o uso en producción usa siempre los endpoints con API Key.

Tasa Histórica por Fecha

Consulta la tasa registrada en una fecha específica. Es un endpoint de acceso libre pensado para integraciones ligeras; para el resto de la API (tasas en tiempo real de dólar, euro y USDT) se requiere API Key.

Request

GET https://bcvapi.cc/api/v1/rate/by-date?date=2026-08-07¤cy=usd

Parámetro currency: usd (dólar), eur (euro) o usdt.

Response

{
  "tasa": 787.52,
  "fecha": "2026-08-26 00:00:00",
  "moneda": "USD",
  "fuente": "BCV",
  "registrado": true
}

Fechas Disponibles en el Historial

Lista todas las fechas con tasa registrada para una moneda, útil para poblar selectores de fecha. Endpoint de acceso libre.

Request

GET https://bcvapi.cc/api/v1/available-dates?currency=usdt

Parámetro currency (opcional, por defecto usd): usd, eur o usdt.

Response

{
  "currency": "usdt",
  "source": "BINANCE_USDT",
  "available_dates": ["2026-08-07", "2026-08-06", "2026-08-05"],
  "date_range": { "min": "2026-06-01", "max": "2026-08-07" },
  "total_dates": 45
}

Ejemplos de Integración

• Python
• JavaScript
• PHP
• cURL

import requests

headers = {'Authorization': 'tu_api_key_aqui'}

# Dólar, euro o USDT (mismo formato de respuesta)
response = requests.get("https://bcvapi.cc/api/v1/dolar", headers=headers)
data = response.json()
print(f"Tasa: {data['tasa']} Bs ({data['fecha']})")

# Tasa histórica por fecha (acceso libre)
historico = requests.get("https://bcvapi.cc/api/v1/rate/by-date", params={
    "date": "2026-08-07",
    "currency": "usdt"
}).json()
print(f"Tasa USDT el {historico['fecha']}: {historico['tasa']} Bs")

// Dólar, euro o USDT (mismo formato de respuesta)
fetch("https://bcvapi.cc/api/v1/dolar", {
  headers: { 'Authorization': 'tu_api_key_aqui' }
})
.then(res => res.json())
.then(data => console.log(`Tasa: ${data.tasa} Bs (${data.fecha})`));

// Tasa histórica por fecha (acceso libre)
fetch("https://bcvapi.cc/api/v1/rate/by-date?date=2026-08-07¤cy=usdt")
  .then(res => res.json())
  .then(data => console.log(`Tasa USDT: ${data.tasa} Bs`));

$context = stream_context_create([
  'http' => [
    'header' => "Authorization: tu_api_key_aqui\r\n"
  ]
]);

// Dólar, euro o USDT (mismo formato de respuesta)
$response = file_get_contents(
  "https://bcvapi.cc/api/v1/dolar",
  false,
  $context
);
$data = json_decode($response, true);
echo "Tasa: " . $data["tasa"] . " Bs (" . $data["fecha"] . ")\n";

// Tasa histórica por fecha (acceso libre)
$historico = json_decode(file_get_contents(
  "https://bcvapi.cc/api/v1/rate/by-date?date=2026-08-07¤cy=usdt"
), true);
echo "Tasa USDT: " . $historico["tasa"] . " Bs";

# Con API Key (dólar, euro o usdt)
curl -X GET https://bcvapi.cc/api/v1/dolar \
  -H "Authorization: tu_api_key_aqui"

# Acceso libre: tasa histórica por fecha
curl -X GET "https://bcvapi.cc/api/v1/rate/by-date?date=2026-08-07¤cy=usdt"

Códigos de Respuesta