Skip to main content

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​

ParameterTypeRequiredDescription
referencestringYesUnique 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​

FieldTypeDescription
idstringUnique internal transaction identifier.
referencestringTransaction reference number for reconciliation.
currencyFromstringSold currency code.
amountFromnumberSold amount.
currencyTostringBought currency code.
amountTonumberBought amount.
ratenumberLocked rate applied to the conversion.
statusstringExecution status (COMPLETED, PENDING, SETTLED, FAILED).
pricing.overageFeenumberAdditional 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​