Get an FX Rate (v2.1)

Overview

Fetches current indicative foreign exchange rates and a time-bound quote token (vfx_token, valid for 30 seconds) between two specified currencies before booking an FX conversion order.

HTTP Request

GET /banking/ibans/v2/orders/v2.1/fx

Authentication

This endpoint requires an active Bearer JWT token in the Authorization header obtained via POST /banking/ibans/v2/users/login:

Authorization: Bearer <your_access_token>

Code Examples

cURL

curl -X GET "https://api.ahrvo.network/banking/ibans/v2/orders/v2.1/fx" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <your_access_token>"

JavaScript (Axios)

import axios from 'axios';

const response = await axios.get('https://api.ahrvo.network/banking/ibans/v2/orders/v2.1/fx', {
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer <your_access_token>'
  }
});

console.log(response.data);

Python (Requests)

import requests

url = "https://api.ahrvo.network/banking/ibans/v2/orders/v2.1/fx"
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer <your_access_token>" 
}

response = requests.get(url, headers=headers)
print(response.json())

Response (200)

{
  "success": true,
  "rate": 0.6391593,
  "vfx_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJjdXJyZW5jeUZyb20iOiJVU0QiLCJjdXJyZW5jeVRvIjoiR0JQIiwicmF0ZSI6MC42MzkxNTkzLCJzcHJlYWQiOjAuMDcxMDE3NywiaWF0IjoxNjU1Mzc3MjA3LCJleHAiOjE2NTUzNzcyMzd9.MY5CGm0U9MMKH5kT1Vv-tKcxhv3e6_KsODF-NTU5_qo",
  "expiry": "2022-06-16T11:00:37.003Z"
}

Interactive API Explorer

Test this endpoint live against the Ahrvo gateway and Verto sandbox environments: