Exchange Rates

Find Exchange Rate(s) by parameter(s).

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Query Params

source_currency

string | null

required

Source (send) three-letter ISO 4217 currency code

destination_currency

string | null

required

Target (receive) three-letter ISO 4217 currency code

source_amount

number <double> | null

required

Amount in source currency
(either source or target amount is required, do not put both side)

destination_amount

number <double> | null

optional

Amount in destination currency
(either source or target amount is required, do not put both side)

source_country

string

required

Source country

destination_country

string

required

Destination country

Responses

🟢200OK

application/json

Success.

Body

Exchange Rate infomration returned in Response.

source_country

string

required

Source country

Example:

source_currency

string

required

Source (send) three-letter ISO 4217 currency code

Example:

SGD

destination_country

string

required

Destination country

Example:

CN / US / JP / ID

destination_currency

string

required

Target (receive) three-letter ISO 4217 currency code

Example:

CNY / USD / JPY / IDR

source_amount

number <double>

required

Source amount (send)

Example:

1000

destination_amount

number <float>

optional

Amount in destination currency

Example:

943.19

rate

number <float>

optional

Exchange mid-rate

Example:

created_timestamp

string <date-time>

optional

Exchange rate creation date time in ISO8601 format (e.g 2018-03-22T16:08:02+00:00)

Example:

2020-12-01T11:33:45.8758154+00:00

last_modified_timestamp

string <date-time>

optional

Last modified date time in ISO8601 format (e.g. 2018-03-22T16:08:02+00:00)

fee

number <float>

optional

Conversion fee imposed by Transwap

transaction_fee

number <float>

optional

Transaction fee imposed by Transwap partners (Bank/Non-Bank)

Example:

87.11

ts_rate

number <float>

optional

Our rate with commissions

Example:

1.03319

ts_inverse_rate

number <float>

optional

Transwap inverse rate = 1 / ts_rate

min_source_amount

number <double>

optional

Minimum source amount to send for remittance transaction

Example:

100

Example

{
  "source_country": "HK",
  "source_currency": "HKD",
  "destination_country": "MO",
  "destination_currency": "MOP",
  "source_amount": 1000,
  "destination_amount": 943.19,
  "rate": 1.03319,
  "created_timestamp": "2020-12-01T11:33:45.8758154+00:00",
  "last_modified_timestamp": null,
  "fee": 87.11,
  "transaction_fee": 87.11,
  "ts_rate": 1.03319,
  "ts_inverse_rate": null,
  "min_source_amount": 100
}

🟠400Bad Request

🟠401Unauthorized

🟠429429

🔴500Server Error

Request

Request samples

Responses