API del Banco Central de Venezuela (BCV)
Scraper web y API REST para obtener el tipo de cambio del USD desde el Banco Central de Venezuela en tiempo real.
Caracteristicas
- Scraping automatico del tipo de cambio USD/Bs
- API REST con FastAPI
- Conversion automatica USD - Bs
- Documentacion interactiva (Swagger UI)
- CORS habilitado
- Respuestas rapidas y confiables
Instalacion
pip install -r requirements.txt
Uso del Scraper
Uso basico
from bcv_scraper import BCVScraper
# Obtener solo el valor numerico
valor = BCVScraper().get_usd_value()
print(f"USD: {valor} Bs")
# O con informacion completa
scraper = BCVScraper()
resultado = scraper.obtener_valor_usd()
if resultado['exito']:
print(f"Valor: {resultado['valor']} Bs")
print(f"Fecha: {resultado['fecha']}")
# Obtener solo el valor numerico
valor = BCVScraper().get_usd_value()
print(f"USD: {valor} Bs")
# O con informacion completa
scraper = BCVScraper()
resultado = scraper.obtener_valor_usd()
if resultado['exito']:
print(f"Valor: {resultado['valor']} Bs")
print(f"Fecha: {resultado['fecha']}")
API REST
Iniciar el servidor
python api_server.py
El servidor estara disponible en: http://localhost:8000
Endpoints disponibles
1. Obtener valor del USD completo
GET http://localhost:8000/usd
Respuesta:
{
"exito": true,
"moneda": "USD",
"valor": 285.059,
"valor_formateado": "285,059",
"fecha": "2025-12-21",
"timestamp": "2025-12-21T13:30:00"
}
"exito": true,
"moneda": "USD",
"valor": 285.059,
"valor_formateado": "285,059",
"fecha": "2025-12-21",
"timestamp": "2025-12-21T13:30:00"
}
2. Obtener solo el valor numerico
GET http://localhost:8000/usd/simple
Respuesta:
{
"valor": 285.059
}
"valor": 285.059
}
3. Convertir USD a Bolivares
GET http://localhost:8000/convert/100
Respuesta:
{
"exito": true,
"usd": 100,
"bolivares": 28505.9,
"tasa": 285.059,
"fecha": "2025-12-21"
}
"exito": true,
"usd": 100,
"bolivares": 28505.9,
"tasa": 285.059,
"fecha": "2025-12-21"
}
4. Estado del servidor
GET http://localhost:8000/health
5. Documentacion interactiva
http://localhost:8000/docs
Ejemplos de Uso
Python
Opcion 1: Usar el Scraper Directamente
from bcv_scraper import BCVScraper
# Forma simple - Solo el valor
valor = BCVScraper().get_usd_value()
print(f"USD: {valor} Bs")
# Forma completa - Con toda la informacion
scraper = BCVScraper()
resultado = scraper.obtener_valor_usd()
if resultado['exito']:
print(f"Moneda: {resultado['moneda']}")
print(f"Valor: {resultado['valor']} Bs")
print(f"Fecha: {resultado['fecha']}")
# Forma simple - Solo el valor
valor = BCVScraper().get_usd_value()
print(f"USD: {valor} Bs")
# Forma completa - Con toda la informacion
scraper = BCVScraper()
resultado = scraper.obtener_valor_usd()
if resultado['exito']:
print(f"Moneda: {resultado['moneda']}")
print(f"Valor: {resultado['valor']} Bs")
print(f"Fecha: {resultado['fecha']}")
Opcion 2: Consumir la API REST
import requests
# Obtener valor del USD
response = requests.get("http://localhost:8000/usd/simple")
data = response.json()
print(f"USD: {data['valor']} Bs")
# Obtener informacion completa
response = requests.get("http://localhost:8000/usd")
data = response.json()
if data['exito']:
print(f"Valor: {data['valor']} Bs")
print(f"Fecha: {data['fecha']}")
# Convertir 100 USD a Bs
response = requests.get("http://localhost:8000/convert/100")
data = response.json()
print(f"100 USD = {data['bolivares']:,.2f} Bs")
print(f"Tasa: {data['tasa']} Bs/USD")
# Obtener valor del USD
response = requests.get("http://localhost:8000/usd/simple")
data = response.json()
print(f"USD: {data['valor']} Bs")
# Obtener informacion completa
response = requests.get("http://localhost:8000/usd")
data = response.json()
if data['exito']:
print(f"Valor: {data['valor']} Bs")
print(f"Fecha: {data['fecha']}")
# Convertir 100 USD a Bs
response = requests.get("http://localhost:8000/convert/100")
data = response.json()
print(f"100 USD = {data['bolivares']:,.2f} Bs")
print(f"Tasa: {data['tasa']} Bs/USD")
WinDev (PCSoft)
Ejemplo Basico - Obtener Valor del USD
PROCEDURE GetUSDValue()
// Variables
sURL is string = "http://localhost:8000/usd/simple"
httpRQ is httpRequest
httpRP is httpResponse
vJSON is Variant
nUSDValue is numeric
// Configurar la peticion
httpRQ.URL = sURL
httpRQ.Method = httpGet
// Ejecutar la peticion
httpRP = HTTPSend(httpRQ)
// Verificar si la peticion fue exitosa
IF httpRP.StatusCode = 200 THEN
// Parsear el JSON
vJSON = JSONToVariant(httpRP.Content)
// Obtener el valor
nUSDValue = vJSON.valor
// Mostrar el resultado
Info("Valor del USD: " + NumToString(nUSDValue, "12.4f") + " Bs")
RESULT nUSDValue
ELSE
Error("Error al obtener el valor del USD")
RESULT 0
END
Ejemplo en un Boton
// Codigo del boton BTN_GetUSD
nValue is numeric
nValue = GetUSDValue()
IF nValue > 0 THEN
EDT_USDValue = NumToString(nValue, "12.4f")
END
Convertir USD a Bolivares
PROCEDURE ConvertUSDtoBS(nAmountUSD is numeric)
// Variables
sURL is string
httpRQ is httpRequest
httpRP is httpResponse
vJSON is Variant
// Construir la URL
sURL = "http://localhost:8000/convert/" + NumToString(nAmountUSD, "12.2f")
// Configurar y ejecutar la peticion
httpRQ.URL = sURL
httpRQ.Method = httpGet
httpRP = HTTPSend(httpRQ)
// Procesar respuesta
IF httpRP.StatusCode = 200 THEN
vJSON = JSONToVariant(httpRP.Content)
IF vJSON.exito = True THEN
Info(NumToString(vJSON.usd, "12.2f") + " USD = " +
NumToString(vJSON.bolivares, "12.2f") + " Bs")
RESULT vJSON.bolivares
END
END
RESULT 0
Ejemplo Simplificado (Una Linea)
PROCEDURE GetUSD_Simple()
// Variables
sResponse is string
vJSON is Variant
// Peticion directa
sResponse = HTTPRequest("http://localhost:8000/usd/simple")
vJSON = JSONToVariant(sResponse)
RESULT vJSON.valor
Ver ejemplo completo: ejemplo_windev.wl
JavaScript
response.json())
.then(data => console.log(`USD: ${data.valor} Bs`));
// Convertir USD a Bs
fetch('http://localhost:8000/convert/100')
.then(response => response.json())
.then(data => console.log(`100 USD = ${data.bolivares} Bs`));">// Obtener valor del USD
fetch('http://localhost:8000/usd')
.then(response => response.json())
.then(data => console.log(`USD: ${data.valor} Bs`));
// Convertir USD a Bs
fetch('http://localhost:8000/convert/100')
.then(response => response.json())
.then(data => console.log(`100 USD = ${data.bolivares} Bs`));
fetch('http://localhost:8000/usd')
.then(response => response.json())
.then(data => console.log(`USD: ${data.valor} Bs`));
// Convertir USD a Bs
fetch('http://localhost:8000/convert/100')
.then(response => response.json())
.then(data => console.log(`100 USD = ${data.bolivares} Bs`));
Caracteristicas
- Scraping robusto con multiples metodos de extraccion
- API REST con FastAPI
- Documentacion automatica (Swagger UI)
- CORS habilitado para peticiones desde cualquier origen
- Manejo de errores SSL
- Conversion automatica de USD a Bolivares
- Endpoints simples y completos
Dependencias
requests: Para hacer peticiones HTTPbeautifulsoup4: Para parsear HTMLlxml: Parser HTML rapidofastapi: Framework para la API RESTuvicorn: Servidor ASGI para FastAPI
- El scraper desactiva la verificacion SSL debido a problemas con el certificado del BCV
- Los valores se extraen directamente de la pagina web oficial del BCV
- La API puede ser accedida desde cualquier origen (CORS habilitado)