API Documentation

Integra tipos de cambio en tu aplicación

Introducción

La API de DivisasHoy.com te permite obtener tipos de cambio actualizados y realizar conversiones de divisas de forma programática.

Base URL: https://divisashoy.com/api

Rate Limiting

La API está limitada a 60 solicitudes por minuto por IP. Los headers X-RateLimit-* indican tu uso actual.

GET /api/convert

Convierte una cantidad de una moneda a otra.

Parameters

Name Type Description
amount number Cantidad a convertir
from string Código de moneda origen (ej: USD)
to string Código de moneda destino (ej: MXN)

Example

curl "https://divisashoy.com/api/convert?amount=100&from=USD&to=MXN"

Response

{
  "success": true,
  "data": {
    "amount": 100,
    "from": "USD",
    "to": "MXN",
    "result": 1715.0,
    "rate": 17.15,
    "formatted": "1,715.00",
    "updated_at": "2025-01-19 12:00:00"
  }
}
GET /api/rates

Obtiene todos los tipos de cambio disponibles.

Example

curl "https://divisashoy.com/api/rates"

Response

{
  "success": true,
  "base": "USD",
  "rates": {
    "EUR": { "code": "EUR", "rate": 0.92, "change": "up" },
    "MXN": { "code": "MXN", "rate": 17.15, "change": "down" },
    ...
  },
  "updated_at": "2025-01-19 12:00:00"
}
GET /api/rate/{code}

Obtiene el tipo de cambio de una moneda específica.

Example

curl "https://divisashoy.com/api/rate/MXN"
GET /api/currencies

Lista todas las monedas soportadas.

Example

curl "https://divisashoy.com/api/currencies"
POST /api/batch-convert

Realiza múltiples conversiones en una sola solicitud (máximo 50).

Request Body

{
  "conversions": [
    { "amount": 100, "from": "USD", "to": "MXN" },
    { "amount": 50, "from": "EUR", "to": "GBP" }
  ]
}

Example

curl -X POST "https://divisashoy.com/api/batch-convert" \
  -H "Content-Type: application/json" \
  -d '{"conversions":[{"amount":100,"from":"USD","to":"MXN"}]}'

Monedas Soportadas

USD
EUR
MXN
GBP
JPY
CAD
AUD
CHF
CNY
BRL
ARS
COP
CLP
PEN
INR