Exchange Rate Endpoint
GET
/exchangeConsulta las tasas de cambio actuales entre diferentes monedas
Objetivo
Permite obtener las tasas de cambio en tiempo real para convertir entre diferentes monedas soportadas por la plataforma.
Request
Headers
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
x-api-key | String | Sí | API Key requerida para acceder a este endpoint. |
x-authorization-token | String | Sí | Token de acceso generado al hacer login. |
Query Parameters
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
from | String | No | Moneda de origen (ej: USD, ARS, MXN). Si no se especifica, devuelve todas las conversiones disponibles. |
to | String | No | Moneda de destino (ej: USD, ARS, MXN). Si no se especifica, devuelve conversiones a todas las monedas. |
amount | Number | No | Monto a convertir. Si se especifica, devuelve el monto convertido además de la tasa. |
Response
Response Body
| Parámetro | Tipo | Descripción |
|---|---|---|
exchanges | Object[] | Lista de tasas de cambio disponibles. |
tx | String | ID interno de transacción. |
mainTx | String | ID principal de transacción. |
Response Examples
200 OK
Consideraciones
- Las tasas de cambio se actualizan cada 5 minutos durante horarios de mercado.
- Si no se especifican parámetros, se devuelven todas las conversiones disponibles.
- Las monedas soportadas incluyen: USD, ARS, MXN, CLP, COP, PEN.
- El campo convertedAmount solo aparece si se especifica un monto en la consulta.
CLIENT LIBRARIES
REQUEST EXAMPLE
curl --request GET \ --url https://tools.homo.tapila.cloud/exchange?from=USD&to=ARS&amount=10 \ --header 'x-authorization-token: YOUR_TOKEN_HERE' \ --header 'x-api-key: YOUR_API_KEY_HERE'