Documentación API tasa BCV

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": 880.12,
  "fuente": "https://www.bcv.org.ve/",
  "fecha": "2026-10-16",
  "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 cupo limitado de 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": 880.12,
  "fecha": "2026-10-16 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
• Node.js
• PHP
• Laravel
• Flutter
• 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")

// Node.js (fetch nativo en v18+)
const apiKey = process.env.BCV_API_KEY;

const response = await fetch("https://bcvapi.cc/api/v1/dolar", {
  headers: { Authorization: apiKey }
});
const data = await response.json();
console.log(`Tasa: ${data.tasa} Bs (${data.fecha})`);

// Tasa histórica por fecha (acceso libre)
const historico = await fetch(
  "https://bcvapi.cc/api/v1/rate/by-date?date=2026-08-07¤cy=usdt"
).then(res => res.json());
console.log(`Tasa USDT: ${historico.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";

// config/services.php
'bcvapi' => [
    'url' => env('BCV_API_URL', 'https://bcvapi.cc'),
    'key' => env('BCV_API_KEY'),
],

// En un servicio o controlador
use Illuminate\Support\Facades\Http;

$response = Http::withHeaders([
    'Authorization' => config('services.bcvapi.key'),
])->get(config('services.bcvapi.url') . '/api/v1/dolar');

if ($response->successful()) {
    $tasa = $response->json('tasa');
    $fecha = $response->json('fecha');
}

// Tasa histórica por fecha (acceso libre, sin API Key)
$historico = Http::get(config('services.bcvapi.url') . '/api/v1/rate/by-date', [
    'date' => '2026-08-07',
    'currency' => 'usd',
])->json();

import 'dart:convert';
import 'package:http/http.dart' as http;

const apiKey = String.fromEnvironment('BCV_API_KEY');
const baseUrl = 'https://bcvapi.cc';

Future<Map<String, dynamic>> obtenerTasaDolar() async {
  final response = await http.get(
    Uri.parse('$baseUrl/api/v1/dolar'),
    headers: {'Authorization': apiKey},
  );

  if (response.statusCode == 200) {
    return jsonDecode(response.body) as Map<String, dynamic>;
  }
  throw Exception('Error ${response.statusCode}: ${response.body}');
}

// Tasa histórica por fecha (acceso libre)
Future<Map<String, dynamic>> tasaPorFecha(String fecha) async {
  final uri = Uri.parse('$baseUrl/api/v1/rate/by-date')
      .replace(queryParameters: {'date': fecha, 'currency': 'usd'});
  final response = await http.get(uri);
  return jsonDecode(response.body) as Map<String, dynamic>;
}

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

Casos de uso reales

Integraciones típicas en Venezuela donde la tasa oficial del BCV es obligatoria o la referencia legal.

¿Por qué usar la API oficial en lugar de scrapear bcv.org.ve?

Muchos equipos intentan extraer la tasa directamente del sitio del BCV. Funciona hasta que deja de funcionar — y en producción eso cuesta dinero.

Códigos de error y respuestas

Todas las respuestas de error son JSON con al menos los campos error y mensaje. Algunas incluyen upgrade_url para renovar o ampliar el plan.

Ejemplos de cuerpo de error

{
  "error": "Acceso denegado",
  "mensaje": "Debes estar registrado para acceder a la API..."
}

{
  "error": "Límite mensual alcanzado",
  "mensaje": "...",
  "consultation_limit": 100,
  "upgrade_url": "https://bcvapi.cc/user/subscription"
}

{
  "error": "Acceso denegado",
  "mensaje": "Esta tasa (Euro) es exclusiva para planes...",
  "upgrade_url": "https://bcvapi.cc/user/subscription"
}

{
  "error": "Límite de solicitudes alcanzado",
  "mensaje": "Has superado tu cuota diaria...",
  "limit": 50,
  "used": 50,
  "reset_at": "2026-09-01 00:00:00"
}