Get an FX Trade (New)

Overview

Retrieve detailed information for a specific foreign exchange trade by its unique transaction reference or ID.

Resource Access

• HTTP Method: GET
• Endpoint: /banking/ibans/v2/fx/{reference}
• Authentication: Bearer token required (Authorization: Bearer {access_token})

Path Parameters

Parameter	Type	Required	Description
reference	string	Yes	Unique FX trade reference (e.g. EN-05062024-055) or trade ID.

Response

Success Response (200 OK)

{
  "id": "20088",
  "reference": "EN-05062024-055",
  "userId": "2289",
  "companyId": "2233",
  "currencyFrom": "USD",
  "amountFrom": 4800,
  "currencyTo": "NGN",
  "amountTo": 4936560,
  "rate": 1028.4456,
  "status": "COMPLETED",
  "pricing": {
    "overageFee": 0,
    "feeCurrency": "USD"
  },
  "createdAt": "2026-09-15T12:00:05Z"
}

Response Fields

Field	Type	Description
id	string	Unique internal transaction identifier.
reference	string	Transaction reference number for reconciliation.
currencyFrom	string	Sold currency code.
amountFrom	number	Sold amount.
currencyTo	string	Bought currency code.
amountTo	number	Bought amount.
rate	number	Locked rate applied to the conversion.
status	string	Execution status (COMPLETED, PENDING, SETTLED, FAILED).
pricing.overageFee	number	Additional fee or markup applied.

Error Responses

• 401 Unauthorized: Missing or invalid Bearer token.
• 404 Not Found: Trade with the given reference was not found.
• 500 Internal Server Error: Internal platform error.

Code Examples

cURL

curl -X GET "https://api.ahrvo.network/banking/ibans/v2/fx/EN-05062024-055" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Accept: application/json"

Python

import requests

url = "https://api.ahrvo.network/banking/ibans/v2/fx/EN-05062024-055"
headers = {
    "Authorization": "Bearer YOUR_ACCESS_TOKEN",
    "Accept": "application/json"
}

response = requests.get(url, headers=headers)
data = response.json()
print("Trade Status:", data.get("status"))
print(f"{data.get('amountFrom')} {data.get('currencyFrom')} -> {data.get('amountTo')} {data.get('currencyTo')}")

JavaScript / Node.js

const response = await fetch("https://api.ahrvo.network/banking/ibans/v2/fx/EN-05062024-055", {
  method: "GET",
  headers: {
    "Authorization": "Bearer YOUR_ACCESS_TOKEN",
    "Accept": "application/json"
  }
});

const trade = await response.json();
console.log("Trade:", trade.reference, "Status:", trade.status);

Interactive API Explorer