Tasa BCV histórica
Consulta la tasa del bolívar de cualquier día. Ideal para contabilidad, reconciliación, reportes financieros y auditoría.
curl https://api.cotizave.com/v1/fx/rates/reference/history?date=2026-03-15 \ -H "X-API-Key: TU_API_KEY"
{
"market": "reference",
"date": "2026-03-15",
"rate": 49.87,
"updated_at": "2026-03-15T10:30:00Z",
"captured_at": "2026-03-15T10:30:00Z"
}curl "https://api.cotizave.com/v1/fx/rates/reference/history?from=2026-03-01&to=2026-03-31" \
-H "X-API-Key: TU_API_KEY"
# → { "from": "...", "to": "...", "granularity": "daily", "count": 31, "points": [ ... ] }Por fecha o por rango
GET /v1/fx/rates/:market/history?date= devuelve la tasa de un día; con ?from=&to= (o sin parámetros) devuelve la serie completa de tu retención, un punto por día o intradía con granularity=raw.
Todos los markets
Cubre BCV (reference), paralela y los exchanges P2P bajo el mismo contrato.
Para auditoría
Incluye captured_at y updated_at con el timestamp exacto de publicación del BCV. Válido como respaldo documental.
Para qué se usa
- Reconciliación contable mes a mes
- Reportes financieros con tasa del día correcto
- Auditoría y cumplimiento
- Análisis y series temporales del bolívar
- Dashboards y BI
Preguntas frecuentes
¿Qué devuelve el endpoint histórico exactamente?
Devuelve la tasa del market más cercana a la fecha pedida, sin excederla. Los campos rate, updated_at y captured_at identifican el valor con su timestamp exacto de publicación del BCV.
¿Qué pasa si no hay tasa registrada para esa fecha?
La API responde 404. Esto puede ocurrir si la fecha pedida es anterior al inicio de la recopilación de datos. La práctica recomendada es guardar rate y updated_at junto a cada transacción como respaldo adicional.
¿Qué markets cubre el endpoint histórico?
Cubre todos los markets disponibles en la API: reference (BCV), parallel, binance, bybit, okx, bitget, mexc, bingx, coinex y saldo.
¿Los datos históricos son inmutables?
Sí. Una vez registrada la tasa de un período, el dato no se modifica. Esto garantiza reproducibilidad, requisito para auditoría y contabilidad.