Skip to main content
GET
Get Current Rates
curl --request GET \
  --url https://api.example.com/
{
  "message": "<string>",
  "bcv": {
    "value": "<string>",
    "date": "<string>"
  },
  "banplus": {
    "value": "<string>",
    "date": "<string>"
  },
  "bnc": {
    "value": "<string>",
    "date": "<string>"
  },
  "bdv": {
    "value": "<string>",
    "date": "<string>"
  }
}

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/MiguelNavas19/miapibcv/llms.txt

Use this file to discover all available pages before exploring further.

​
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.
​
banplus
object
Exchange rate data from Banplus Banco Universal.
​
bnc
object
Exchange rate data from Banco Nacional de Crédito.
​
bdv
object
Exchange rate data from Banco de Venezuela.

​
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 -X GET https://your-domain.com/api/ \
  -H "Accept: application/json"

​
Example Response

{
  "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 CodeDescription
200Success - Returns exchange rates for all available banks
404Not 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

Build docs developers (and LLMs) love

Get started for freeTalk to us