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 si la fecha es anterior al inicio de la serie de ese market. Si en cambio la fecha excede la retención de tu plan, responde 403: el dato existe, pero tu plan no alcanza. 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 de la API: reference, eur_reference, yadio, parallel, binance, bybit, okx, bitget, mexc, bingx, saldo, paypal, zelle, cash, cucuta, syklo, zoom, western_union. La profundidad varía según el market — el detalle está en la documentación del endpoint.
¿Cuánto histórico hay disponible en cada market?
reference, eur_reference: toda la retención de tu plan. yadio: toda la retención de tu plan. parallel: desde febrero 2026. binance, bybit, okx, bitget, mexc, bingx, saldo: desde mayo 2026. paypal, zelle: desde agosto 2026. cash, cucuta, syklo, zoom, western_union: desde agosto 2026.
¿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.