Introduction

The Exchange Rates API provides real-time and historical foreign exchange rate data for banks in the Dominican Republic. This endpoint allows users to retrieve filtered exchange rate records based on various criteria.

Base URL

https://cmsp.cloud/exchange-rates/DO

HTTP Method

GET

Query Parameters

You can use the following query parameters to filter the response. All parameters are optional unless otherwise stated:

1. limit

• Type: integer
• Description: Specifies the maximum number of records to return.
• Constraints: Cannot exceed 1000.
• Default Value: None (returns all records if not specified).

Example: ?limit=500

2. date

• Type: string (formatted as dd-mm-yyyy)
• Description: Filters records by a specific date.
• Constraints: Must follow the dd-mm-yyyy format.
• Default Value: None (returns all available dates if not specified).

Example: ?date=25-11-2024

3. banks

• Type: string (comma-separated list)
• Description: Filters records by one or more banks.
• Valid Values:
  • apap: Asociación Popular de Ahorros y Préstamos
  • bpd: Banco Popular Dominicano
  • bc: BanReservas
  • bsc: Banco de Servicios Corporativos
  • res: Banco Central de la República Dominicana
  • pro: Promerica Bank
• Default Value: None (returns data for all banks if not specified).

Example: ?banks=apap,bpd

4. currency

• Type: string
• Description: Filters records by currency type.
• Valid Values:
  • EUR: Euro
  • USD: United States Dollar
• Default Value: None (returns data for all supported currencies if not specified).

Example: ?currency=USD

5. fields

• Type: string (comma-separated list)
• Description: Specifies which fields to include in the response.
• Available Fields:
  • currency: Currency type (e.g., USD, EUR).
  • rate: Exchange rate value.
  • operation_type: Type of operation (buy or sell).
  • bank: Name of the bank.
  • date: Date of the exchange rate.
• Default Value: All fields are included.

Example: ?fields=currency,rate,date

6. operation_type

• Type: string
• Description: Filters records by the type of exchange operation.
• Valid Values:
  • buy: Buying exchange rate.
  • sell: Selling exchange rate.
• Default Value: None (returns both buy and sell operations).

Example: ?operation_type=buy

Endpoint Example

Request:

GET https://cmsp.cloud/exchange-rates/DO?limit=100&date=26-11-2024&banks=apap,bpd&currency=USD&fields=currency,rate,bank,operation_type&operation_type=buy

Response (JSON):

[
    { "currency": "USD", "rate": 56.75,
        "operation_type": "buy",
        "bank": "Banco Popular Dominicano",
        "date": "26-11-2024"
    },
    {
        "currency": "USD",
        "rate": 56.60,
        "operation_type": "buy",
        "bank": "Asociación Popular de Ahorros y Préstamos",
        "date": "26-11-2024"
    }
]