Single rate

GET

/reference-data/fx/{sourceCurrency}/{targetCurrency}

const url = 'https://api.wink.travel/reference-data/fx/USD/THB';
const options = {
  method: 'GET',
  headers: {'Wink-Version': '2.0', Authorization: 'Bearer <token>'}
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url https://api.wink.travel/reference-data/fx/USD/THB \
  --header 'Authorization: Bearer <token>' \
  --header 'Wink-Version: 2.0'

Returns the exchange-rate quote between a specific source and target currency pair, or fails if no quote exists.

Authorizations

oauth2ClientCredentials

Parameters

Path Parameters

sourceCurrency

required

string

ISO 4217 source currency code

Example

USD

targetCurrency

required

string

ISO 4217 target currency code

Example

THB

Header Parameters

Wink-Version

string

default: 2.0.0

Allowed values: 2.0

Responses

200

Exchange-rate quote for the requested currency pair

application/json

Lightweight representation of an exchange rate quote between a source and target currency pair

object

source

required

ISO 4217 source currency code

string

"" >= 1 characters

target

required

ISO 4217 target currency code

string

"" >= 1 characters

exchangeRate

required

Exchange rate from source to target currency

number

timestamp

required

Unix epoch milliseconds when the quote was recorded

integer format: int64

key

additional properties

Example

{
  "source": "USD",
  "target": "THB",
  "exchangeRate": 33.5,
  "timestamp": 1705233000000
}

400

Bad Request — missing or invalid request parameter or body

application/problem+json

object

type

string format: uri

title

string

status

integer format: int32

detail

string

instance

string format: uri

properties

object

key

additional properties

key

additional properties

Example

401

Unauthorized — authentication is required or the session has expired

application/problem+json

object

type

string format: uri

title

string

status

integer format: int32

detail

string

instance

string format: uri

properties

object

key

additional properties

key

additional properties

Example

403

Forbidden — authenticated but lacking the required permission or scope

application/problem+json

object

type

string format: uri

title

string

status

integer format: int32

detail

string

instance

string format: uri

properties

object

key

additional properties

key

additional properties

Example

404

Not Found — the requested resource does not exist

application/problem+json

object

type

string format: uri

title

string

status

integer format: int32

detail

string

instance

string format: uri

properties

object

key

additional properties

key

additional properties

Example

405

Method Not Allowed — the HTTP verb is not supported on this endpoint

application/problem+json

object

type

string format: uri

title

string

status

integer format: int32

detail

string

instance

string format: uri

properties

object

key

additional properties

key

additional properties

Example

415

Unsupported Media Type — use application/json

application/problem+json

object

type

string format: uri

title

string

status

integer format: int32

detail

string

instance

string format: uri

properties

object

key

additional properties

key

additional properties

Example

422

No quote exists for the requested currency pair

application/json

Lightweight representation of an exchange rate quote between a source and target currency pair

object

source

required

ISO 4217 source currency code

string

"" >= 1 characters

target

required

ISO 4217 target currency code

string

"" >= 1 characters

exchangeRate

required

Exchange rate from source to target currency

number

timestamp

required

Unix epoch milliseconds when the quote was recorded

integer format: int64

Example

null

500

Internal Server Error — an unexpected failure occurred on the server

application/problem+json

object

type

string format: uri

title

string

status

integer format: int32

detail

string

instance

string format: uri

properties

object

key

additional properties

key

additional properties

Example

503

Service Unavailable — a downstream dependency is unreachable

application/problem+json

object

type

string format: uri

title

string

status

integer format: int32

detail

string

instance

string format: uri

properties

object

key

additional properties

key

additional properties