F/X Currency Calculator

This API calculate the equivalent of target currency rate for a specific currency amount based on input information.

API Information

URL

 /currencyCalculator

Method

 POST

Version

 1.0

Scope

 public

Authorization Flow

 Client Credentials


Input Information

Name Format Description Required/Optional

SourceCurrencyCode

 String Source currency code Required

SourceAmount

 Number Source amount Required

TargetCurrencyCode

 String Target currency code Required


Output Information

Currency

Name Format Description

TargetCurrencyCode

 String Target currency code

RateDate

 yyyy-MM-ddTHH24:mm:ss F/X currency rate date

SaleRate

 Decimal Bank sale rate

SaleAmount

 Decimal Bank sales amount


Message Codes

Message Code Description

ACBH000017

The target currency code must consist of letters.

ACBH000018

The source currency code must consist of letters.

ACBH000051

An invalid data was entered in the source amount field.

ACBH000075

Source amount cannot be empty.

Example

Request:

{
    "SourceCurrencyCode": "TL",
    "SourceAmount": "100",
    "TargetCurrencyCode": "USD"
}

Response:

{
    "Header": {
        "StatusCode": "APIGW000000",
        "StatusDescription": "Completed",
        "ObjectID": "34600dc7-fe10-4394-a99a-36e28c9e3d3f"
    },
    "Data": {
        "Currency": {
            "RateDate": "2020-06-01T16:46:56.6790594+03:00",
            "SaleRate": "6.8466",
            "TargetCurrencyCode": "USD",
            "SaleAmount": "14.6"
        }
    }
}