Banco Central de Cuba Exchange Rate API: Official CUP (Peso) Rates as JSON

The Banco Central de Cuba publishes the official exchange rates that accounting, tax, and customs rules in Cuba reference — published official rates, not moving market prices. This guide shows how to pull them as JSON: via a REST endpoint or the zero-dependency banco-central-de-cuba-exchange-rate npm package.

What the BCC publishes

• Three official rates per currency — the Segment I official rate for the state sector (24 pesos per dollar), the Segment II population rate (120 pesos) and the Segment III special rate the bank has set daily since December 2025 (681 pesos per dollar on 26 September 2026). The API returns them as rate types official, public and special, never mixed.
• 13 currencies in CUP per unit — USD, EUR, GBP, CAD, CHF, JPY, CNY, RUB, MXN, AUD, SEK, NOK and DKK, straight from the bank's own published table.
• Published every business day with weekend carry-over — the bank posts day D's table on the afternoon of D-1 and states its validity window; the API keys every row on the table's own date.
• History back to 19 December 2025 in our API, the first day of the bank's published series, queryable by exact date or as a series.

Cuba's peso has more than one official value, and which one applies depends on who is converting. That is exactly why the segment matters on every row: a state-enterprise invoice at 24, a population exchange at 120 and the new market-linked special rate at 681 are all "the official rate" in their own context. The API keeps them apart and dates each one.

Why official rates, not market rates

A live mid-market feed answers "what is USD/CUP trading at right now?" — the right tool for checkouts and dashboards. But accountants, auditors, and tax authorities ask a different question: "which rate were you required to use for this date?" That answer comes from the Banco Central de Cuba's published rates, and it never changes after publication.

Get the latest rates (REST)

curl "https://allratestoday.com/api/v1/central-bank/bccu/latest" \
  -H "Authorization: Bearer YOUR_API_KEY"

The response is the bank's most recent published data — every rate and the publication date. The latest rates are available on every plan, including the free tier (300 requests/month, no credit card).

The npm SDK

npm install banco-central-de-cuba-exchange-rate

import { getRate, getLatestRates } from 'banco-central-de-cuba-exchange-rate';

// One pair at the official BCC rate
const pair = await getRate('USD', 'CUP', { apiKey: 'art_live_...' });
console.log(pair.rate, pair.rate_date);

// The bank's full published table
const table = await getLatestRates({ apiKey: 'art_live_...' });
console.log(table.rate_date, table.rates.length);

Zero dependencies, TypeScript types included, and it runs anywhere fetch exists — Node 18+, Bun, Deno, and edge runtimes.

Historical rates for an invoice date

import { getRatesForDate, getHistory } from 'banco-central-de-cuba-exchange-rate';

// The official rates for an invoice date — non-publication days return
// the most recent published date, flagged via published_on_requested_date.
const day = await getRatesForDate('2026-06-30', { apiKey: 'art_live_...' });

// Time series for one pair
const series = await getHistory(
  { source: 'USD', target: 'CUP', from: '2026-01-01' },
  { apiKey: 'art_live_...' }
);

Historical dates and time series need a paid plan; the latest rates stay free.

Published vs derived pairs

If the BCC does not print a pair directly, the API resolves it from the bank's published rates — an inverse, or a cross rate via CUP — and flags it derived: true with the method used. Official and computed values are never silently mixed, which is exactly the distinction an auditor will ask about.

The special rate since December 2025

Our archive starts on 19 December 2025, the day Banco Central de Cuba began publishing the Segment III special rate at 410 pesos per dollar. It has been set daily since, climbing through 500 and 600 to 681 on 26 September 2026, while the Segment I and II rates stayed at 24 and 120. For a past invoice date, one call returns all three segments in force that day; days without a new table resolve to the table then valid and are flagged.

FAQ

Does the Banco Central de Cuba have an official exchange rate API?

The BCC publishes its official rates on its own site, and AllRatesToday serves the same published rates as clean JSON via REST or the banco-central-de-cuba-exchange-rate npm package. The latest rates are free (300 requests/month); historical dates need a paid plan.

How often do Banco Central de Cuba rates update?

Once per business day, as a table of 13 currencies with three rates each — official (Segment I), public (Segment II) and special (Segment III). The bank posts the next day's table the afternoon before and gives it a validity window that covers weekends; every API response carries the table's own date.

Can I get the BCC rate for a past date, like an invoice date?

Yes. The /central-bank/bccu/rates-for-date endpoint returns the official rates for any archived date. Non-publication days resolve to the most recent published date and are flagged via published_on_requested_date.