Get Current Rates

Retrieve today’s exchange rates from all available banks

GET

Get Current Rates

cURL

curl --request GET \
  --url https://api.example.com/

200

{
  "message": "<string>",
  "bcv": {
    "value": "<string>",
    "date": "<string>"
  },
  "banplus": {
    "value": "<string>",
    "date": "<string>"
  },
  "bnc": {
    "value": "<string>",
    "date": "<string>"
  },
  "bdv": {
    "value": "<string>",
    "date": "<string>"
  }
}

Endpoint

GET /

Retrieves the most recent exchange rates from all available Venezuelan banks for today’s date.

Parameters

This endpoint does not accept any parameters.

Response

message · string · required

Status message indicating the result of the query. Returns "Consulta exitosa" on success.

bcv · object

Exchange rate data from Banco Central de Venezuela.

Show properties

value · string

The exchange rate value as a decimal string with up to 4 decimal places.

date · string

The date of the rate in YYYY-MM-DD format.

banplus · object

Exchange rate data from Banplus Banco Universal.

Show properties

value · string

The exchange rate value as a decimal string with up to 4 decimal places.

date · string

The date of the rate in YYYY-MM-DD format.

bnc · object

Exchange rate data from Banco Nacional de Crédito.

Show properties

value · string

The exchange rate value as a decimal string with up to 4 decimal places.

date · string

The date of the rate in YYYY-MM-DD format.

bdv · object

Exchange rate data from Banco de Venezuela.

Show properties

value · string

The exchange rate value as a decimal string with up to 4 decimal places.

date · string

The date of the rate in YYYY-MM-DD format.

Caching

This endpoint caches results for 1 hour (3600 seconds) based on the current date. The cache key format is: tasas_bancos_YYYY-MM-DD

Repeated requests within the same hour will return the cached response without querying the database.

Example Request

cURL

curl -X GET https://your-domain.com/api/ \
  -H "Accept: application/json"

Example Response

200 - Success

{
  "message": "Consulta exitosa",
  "bcv": {
    "value": "45.2500",
    "date": "2026-03-04"
  },
  "banplus": {
    "value": "45.3000",
    "date": "2026-03-04"
  },
  "bnc": {
    "value": "45.2800",
    "date": "2026-03-04"
  },
  "bdv": {
    "value": "45.2600",
    "date": "2026-03-04"
  }
}

Error Cases

404 Not Found - Returned when no exchange rates are available for today’s date. This typically happens early in the morning before the scraping process has completed.

The API returns the error from ScraperController.php:30:

{
  "message": "Tasas no disponibles aún"
}

Response Status Codes

Status Code	Description
200	Success - Returns exchange rates for all available banks
404	Not Found - No rates available for today

Implementation Details

The endpoint is implemented in app/Http/Controllers/Api/ScraperController.php:15-40 and:

1. Generates a unique cache key based on today’s date
2. Queries the database for records where date = today
3. Groups results by source (bank identifier)
4. Returns all bank rates in a single response
5. Caches the result for 1 hour

Next Steps

Get Historical Rates

Query rates for specific dates

Error Handling

Learn how to handle API errors