API Overview

Introduction to Mi API BCV and authentication

Introduction

Mi API BCV provides real-time and historical exchange rate data scraped from major Venezuelan banks. The API is built with Laravel and offers a simple REST interface for accessing currency reference rates.

Base URL

https://your-domain.com/api

Replace your-domain.com with your actual API domain.

Authentication

This API does not require authentication. All endpoints are publicly accessible.

Rate Limiting

The API implements intelligent caching with a 1-hour TTL (Time To Live) for all responses. This helps reduce database load and improves response times.

Request Headers

All API requests should include:

Accept: application/json

The API will return responses in JSON format.

Available Endpoints

The API provides two main endpoints:

Get Current Rates

Retrieve today’s exchange rates from all available banks

Get Historical Rates

Query exchange rates by date and optionally filter by bank

Supported Banks

The API scrapes exchange rates from the following Venezuelan financial institutions:

• bcv - Banco Central de Venezuela
• banplus - Banplus Banco Universal
• bnc - Banco Nacional de Crédito
• bdv - Banco de Venezuela

Common Response Pattern

All successful responses follow this structure:

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

Exchange rates are updated daily. If rates for a specific date haven’t been scraped yet, the API will return a 404 error.

Caching Behavior

All endpoints cache responses for 1 hour (3600 seconds) based on:

• Current date for the root endpoint
• Specific date for historical queries

This means repeated requests within the same hour will return cached data without hitting the database.

Next Steps

Response Structure

Learn about the detailed response format

Error Handling

Understand error codes and how to handle them