Exchange CR
ESEspañol
For developers

Exchange Rate API

Integrate Costa Rica's official USD exchange rate (BCCR) directly into your applications. A single source of truth, always up to date, with no need to connect to the Central Bank yourself.

Request API keyPricing
DocumentationPostmanView query types
Base URL/api/v1

Why use our API?

Fast

Optimized, cached responses that return in milliseconds.

Secure

API key authentication, rate limiting and configurable CORS.

Versioned

Stable endpoints under /api/v1 so your apps never break.

Reliable

Official BCCR data synced every single day.

Pricing

One simple plan with full access to the API.

Pro Plan

$2.99/mo
  • Access to all endpoints
  • 5,000 requests per month
  • Official BCCR data, updated daily
  • Widgets, SDK and support

Custom

Contact us

Need more capacity? We design a plan tailored to your needs.

  • More than 5,000 requests per month
  • Custom limits and endpoints
  • Priority support and SLA
  • Billing tailored to your volume
Contact sales

Query types

Every query returns JSON in a consistent format. These are the available types:

GET/api/v1/exchange-rate/latestRequires API key

Latest rate

Get the most recent buy and sell rate for the USD/CRC pair.

GET/api/v1/exchange-rate?date=YYYY-MM-DDRequires API key

By specific date

Look up the exchange rate for a single day.

GET/api/v1/exchange-rate/history?days=30Requires API key

History

The latest N days of rates (up to 365), perfect for charts.

GET/api/v1/exchange-rate/range?from=…&to=…Requires API key

Date range

Every rate between two dates for period analysis.

GET/api/v1/convert?amount=1000&from=USD&to=CRCRequires API key

Amount converter

Convert amounts between USD and CRC with the official rate.

GET/api/v1/exchange-rate/analytics?days=30Requires API key

Analytics

Average, min, max, change, volatility and trend, already computed.

GET/api/v1/exchange-rate/stats?period=monthly&from=…&to=…Requires API key

Period statistics

Monthly or yearly aggregates for a date range.

GET/api/v1/exchange-rate/chart?days=90&points=60Requires API key

Chart data

Optimized series downsampled to N points, with a trend line.

GET/api/v1/banking/ratesRequires API key

Rates by institution

Per-bank and exchange-house USD buy/sell rates (ventanilla).

GET/api/v1/banking/best?operation=sellRequires API key

Best rate

Which institution buys or sells USD at the best price, with ranking.

GET/api/v1/insights?days=30&locale=esRequires API key

AI Market Insights

AI summary of the likely causes of market movements plus a verdict.

GET/api/v1/healthPublic

Service status

Check the API availability and the latest available date.

Every query requires your API key in the x-api-key header, except the service status.

Example response

Response for the "Latest rate" query:

GET /api/v1/exchange-rate/latest
{
  "success": true,
  "data": {
    "date": "2026-07-19",
    "currencyFrom": "USD",
    "currencyTo": "CRC",
    "buy": 505.12,
    "sell": 512.34,
    "source": "BCCR",
    "fetchedAt": "2026-07-19T12:00:00.000Z"
  }
}

Embeddable widgets

Show the exchange rate on your site with an iframe. No API key, auto-updates.

Widget (card)
<iframe src="https://exchangecr.com/es/widget?theme=auto"
        width="360" height="150" style="border:0"></iframe>
Banner (horizontal)
<iframe src="https://exchangecr.com/es/banner?theme=auto"
        width="640" height="90" style="border:0"></iframe>

View service status →

Ready to integrate?

Get in touch to receive your API key and start consuming exchange rates in minutes.

Request access