API Documentation

REST API to access Dominican Republic exchange rates. All responses are returned as JSON.

Base URL https://tasareal.com/api/v1

Authentication

Include your API key in the Authorization header on every request.

// Required header
Authorization: Bearer your_api_key_here

Get your API key on the pricing page. The free plan includes 50 daily requests.

Endpoints

GET /rates Rates by date

Returns the verified exchange rates from every institution for a given date. Without parameters returns today's rates.

Parameters
date date Date (YYYY-MM-DD). Default: today
currency string Currency: USD, EUR. Default: all
type string Filter by type: bank, exchange, official
institution string Specific institution ID: popular, reservas, etc.
Response
{
  "date": "2026-04-06",
  "currency": "USD",
  "rates": [
    {
      "institution": "popular",
      "name": "Banco Popular",
      "type": "bank",
      "buy": 60.10,
      "sell": 60.80,
      "updated_at": "2026-04-06T14:00:00Z"
    }
  ]
}
GET /rates/history Rate history

Returns the historical rates for an institution and date range.

Parameters
institution string required Institution ID
currency string required USD or EUR
from date required Start date (YYYY-MM-DD)
to date required End date (YYYY-MM-DD)
Response
{
  "institution": "popular",
  "currency": "USD",
  "history": [
    {
      "date": "2026-04-06",
      "buy": 60.10,
      "sell": 60.80
    },
    {
      "date": "2026-04-05",
      "buy": 60.05,
      "sell": 60.75
    }
  ]
}
GET /institutions Institution list

Returns the list of every available institution and its metadata.

Response
{
  "institutions": [
    {
      "id": "popular",
      "name": "Banco Popular",
      "full_name": "Banco Popular Dominicano",
      "type": "bank",
      "website": "https://popularenlinea.com"
    }
  ]
}
GET /rates/best Best rates

Returns the best market buy rate and best market sell rate (officials excluded).

Parameters
currency string required USD or EUR
date date Date (YYYY-MM-DD). Default: today
Response
{
  "date": "2026-04-06",
  "currency": "USD",
  "best_buy": {
    "institution": "quezada",
    "rate": 60.50
  },
  "best_sell": {
    "institution": "quezada",
    "rate": 60.70
  }
}

Limits and error codes

HTTP codes
200 Successful request
401 Missing or invalid API key
403 Your plan does not have access to this resource (e.g. history on the free plan)
429 Daily request limit exceeded
500 Internal server error
Response headers include X-RateLimit-Remaining and X-RateLimit-Limit so you can monitor your usage.
TasaReal.com · Verified exchange rates in the Dominican Republic