Developers

FX API — Cuba

Integrá las tasas Cuba (informal, oficial, cripto) en tu app. Datos mergeados con integrity checks, freshness y provider priority. Conecta directo con el BCC o usa nuestra capa enriquecida.

Live tester

Probar endpoints en vivo

Ejecuta los endpoints públicos directo desde el navegador y copia la respuesta.

// Pulsa Ejecutar para ver la respuesta JSON…

Yordanis Tours

Nuestra API

Capa enriquecida sobre BCC + El Toque, con spread, sparkline y freshness.

Método	Path	Descripción
GET	/api/public/currency/rates	Tasas mergeadas (informal + oficial + cripto).
POST	/_serverFn/getFxOverview	Overview enriquecido (spread, sparkline, freshness).
POST	/_serverFn/convertFxAmount	Conversión entre dos monedas usando el mercado preferido.
POST	/_serverFn/getFxHistory	Histórico 24h/7d/30d por código + market.

Banco Central de Cuba

Integración profesional

Endpoints públicos para tasas activas, por fecha y series históricas.

Tasas activas

Snapshot vigente de todas las monedas publicadas por el BCC.

GEThttps://api.bc.gob.cu/v1/tasas-de-cambio/activas

Tasas por fecha

Cotizaciones vigentes para un día específico (YYYY-MM-DD).

GEThttps://api.bc.gob.cu/v1/tasas-de-cambio/activas-por-fecha?fecha=YYYY-MM-DD

Histórico

Serie histórica. Parámetros: fechaInicio, fechaFin, codigoMoneda.

GEThttps://api.bc.gob.cu/v1/tasas-de-cambio/historico

Ejemplo · histórico

curl "https://api.bc.gob.cu/v1/tasas-de-cambio/historico?fechaInicio=2026-01-01&fechaFin=2026-01-15&codigoMoneda=USD"

Recomendación: cachea la respuesta en tu servidor para reducir carga al upstream.

Documentación

Formatos & canales

OpenAPI, SDMX, feed incremental, webhooks push y verificación de integridad.

OpenAPI / Swagger

Contrato técnico de la API. Permite explorar y probar endpoints desde el navegador.

GEThttps://api.bc.gob.cu/docs

SDMX-JSON

Formato estadístico estándar. Facilita integrar datos en herramientas de análisis (BI, Stata, R).

GEThttps://api.bc.gob.cu/v1/tasas-de-cambio/sdmx

Feed JSON

Canal de novedades. Permite leer actualizaciones sin tener que consultar todo el API.

GEThttps://api.bc.gob.cu/v1/tasas-de-cambio/feed.json

Webhooks

Notificaciones push: tu sistema recibe eventos cuando cambian las tasas.

POSThttps://api.bc.gob.cu/v1/tasas-de-cambio/webhooks/subscribe

Integridad

Verificación de datos: compara el hash para confirmar que el payload no fue alterado.

GEThttps://api.bc.gob.cu/v1/tasas-de-cambio/integrity

MCP

IA-ready · apps inteligentes

Conecta asistentes y agentes con datos oficiales del BCC vía Model Context Protocol. El flujo básico es: inicializar sesión y luego llamar tools — sin integrar el API manualmente.

Uso básico

Endpoint MCP

MCP permite que asistentes y agentes consuman herramientas de tasas sin integrar el API manualmente.

Tools disponibles

tasas.activas · tasas.historico · tasas.por_fecha

Compatible con Claude, GPT, Gemini y cualquier cliente MCP.

Upstream

Fuentes de datos

Banco Central de CubaMercado oficial (PRIMARY)
https://api.bc.gob.cu/v1/tasas-de-cambio/activas
BCC Feed JSONMercado oficial (SECONDARY)
https://api.bc.gob.cu/v1/tasas-de-cambio/feed.json
El ToqueMercado informal + cripto
https://tasas.eltoque.com/v1/trmi

Quality

Reglas de integridad

STALE_AFTER_HOURS = 12 — snapshots más viejos se marcan stale.
FALLBACK_MAX_LIFETIME_HOURS = 24 — fallbacks expirados se descartan del merge.
MAX_DELTA_PCT = 0.5 — cualquier valor que se aleje >50% del ancla se descarta como anomalía.
Priority absoluta: bcc_official_api > el_toque > bcc_official (scraper) > fallbacks > cadeca_static (emergency).
Crypto pairs: BTC/CUP y BTC/MLC conviven en filas separadas (key code+market+market_pair).

Schema

Campos del payload

Campo	Tipo	Descripción
code	string	ISO/cripto: USD, EUR, MLC, BTC, USDT, …
market	enum	`informal` · `official` · `crypto`
market_pair	enum	`CUP` default. Crypto puede exponer `MLC`.
rate	number	Precio canónico (mid para oficial cuando hay compra/venta).
rate_buy	number?	Compra (bid). Sólo BCC oficial.
rate_sell	number?	Venta (ask). Sólo BCC oficial.
spread_pct	number?	`(sell-buy)/buy`. Sólo cuando hay bid/ask separados.
source	enum	`bcc_official_api`, `el_toque`, `cadeca_static`, …
observed_at	ISO 8601	Timestamp del proveedor upstream.