📈FX Rates

🌍 Real-Time Currency Exchange Rates

This endpoint provides real-time foreign exchange rates for supported currency pairs, allowing clients to accurately calculate the equivalent value between different currencies.

It is designed to support cross-currency transactions, financial planning, and international operations, especially for merchants and platforms operating across multiple currency zones.

Exchange rates are sourced from reliable financial data providers and are updated regularly to reflect current market conditions.

✨ Key Benefits

⚡ Real-time FX rates
🌎 Multi-currency support (USD, BRL, EUR, MXN, and more)
🔁 Accurate currency conversion
🏦 Ideal for international merchants and financial platforms
📊 Rates aligned with current market conditions

🧾 Parameters

Name	Type	Required	Description
`from_currency`	string	✅ Yes	Source currency code (e.g. `USD`, `BRL`, `MXN`)
`to_currency`	string	✅ Yes	Target currency code to convert to

📤 Request Example

curl -X POST \
  'https://core-manager.a55.tech/api/v1/bank/wallet/fx/rate/' \
  -H 'accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer {Token}' \
  -d '{
    "from_currency": "USD",
    "to_currency": "BRL"
  }'

📥 Response

✅ 200 OK

Returns the current exchange rate for the requested currency pair.

{
  "price": 5.12
}

price: The conversion rate between the requested currencies

❌ 400 Bad Request

Returned when:

Invalid currency codes are provided
The currency pair is not supported

⚠️ Important Notes

🔢 Exchange rates are rounded to two decimal places
💰 For high-value transactions, small FX variations may have a significant impact on the final amount
⏱ Rates may vary over time as market conditions change

🧠 Common Use Cases

🌐 Cross-border payments
🏦 Multi-currency wallets
📊 Financial reports and projections
🛒 International e-commerce pricing