Sign in

v5

latestOpenAPI 3.1.02026-07-262421791.5 MB
rate

Retrieve current rates

{% admonition type="warning" %} The from, to, and group parameters are not testable in our Sandbox environment at this time. {% /admonition %}

GET /v1/rates<br> Fetch latest exchange rates of all currencies.

GET /v1/rates?source=EUR&target=USD<br> Fetch latest exchange rate of one currency pair.

GET /v1/rates?source=EUR&target=USD&time=2019-02-13T14:53:01<br> Fetch exchange rate of specific historical timestamp.

GET /v1/rates?source=EUR&target=USD&from=2019-02-13T14:53:01&to=2019-03-13T14:53:01&group=day<br> Fetch exchange rate history over period of time with daily interval.

GET /v1/rates?source=EUR&target=USD&from=2019-02-13T14:53:01&to=2019-03-13T14:53:01&group=hour<br> Fetch exchange rate history over period of time with hourly interval.

GET /v1/rates?source=EUR&target=USD&from=2019-02-13T14:53:01&to=2019-03-13T14:53:01&group=minute<br> Fetch exchange rate history over period of time with 1 minute interval.

{% admonition type="warning" %} This endpoint only supports Bearer authentication for non-Affiliate partners. {% /admonition %}

get/v1/rates

Query parameters

sourcestring

Source (send) currency code.

targetstring

Target (receive) currency code.

timestring

Timestamp to get historic exchange rate. <br>Supports only Timestamp (combined date and time). Timezone offset is supported but optional. <br>Supported examples: 2019-03-13T14:53:01 or 2019-03-13T14:53:01+0100.

fromstring

Period start date/time to get exchange rate history. <br>Supports Timestamp (combined date and time) or Date (date only). <br>Supported examples: 2019-03-13T14:53:01 or 2019-03-13.

tostring

Period end date/time to get exchange rate history. <br>Supports Timestamp (combined date and time) or Date (date only). <br>Timezone offset is supported but optional. <br>Supported examples: 2019-03-13T14:53:01+0100 or 2019-03-13+0100.

group'day' | 'hour' | 'minute'

Interval for history grouping.

Headers

X-External-Correlation-Idstring uuid

Optional UUID for correlating requests across systems. If provided, Wise echoes it back in the response. Maximum 36 characters. Learn more.

Response

List of exchange rate values which meet your query criteria.

ratenumber double required

Exchange rate value.

sourcestring required

Source (send) currency code.

targetstring required

Target (receive) currency code.

timestring required

Timestamp for exchange rate.

Example response

[
  {
    "rate": 1.166,
    "source": "EUR",
    "target": "USD",
    "time": "2018-08-31T10:43:31+0000"
  }
]