Rate

Current and historical exchange rates by currency routes.

Endpoints

GET/v1/rates

GET/v1/rates?source=EUR&target=USD

The Rate resource

Fields

ratedecimal

Exchange rate value.

sourcetext

Source(send) currency code

targettext

Target(receive) currency code

timetimestamp

Timestamp for exchange rate.

Rate Object

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

Retrieve current rates

GET /v1/rates

Fetch latest exchange rates of all currencies.

GET /v1/rates?source=EUR&target=USD

Fetch latest exchange rate of one currency pair.

GET /v1/rates?source=EUR&target=USD&time=2019-02-13T14:53:01

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

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

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

Fetch exchange rate history over period of time with 1 minute interval.

Request

Note that this endpoint supports two types of authentication: Bearer token and Basic authentication (client_id/client_secret).

sourcetext

Source(send) currency code.

targettext

Target(receive) currency code.

timetimestamp

Timestamp to get historic exchange rate.

fromtimestamp or date

Period start date/time to get exchange rate history.

totimestamp or date

Period end date/time to get exchange rate history.

grouptext

Interval: day hour minute

Response

List of exchange rate values which meet your query criteria.

Additional notes about date/time formatting used above

The request/response field(s) below support both Timestamp (combined date and time) and Date (date only) formats:

Field	Sample
from	2019-03-13T14:53:01 or 2019-03-13
to	2019-03-13T14:53:01+0100 or 2019-03-13+0100

The request/response field(s) below support only Timestamp (combined date and time):

Field	Sample
time	2019-03-13T14:53:01 or 2019-03-13T14:53:01+0100

Timezone offset is supported but optional.

Example Request (Bearer token)

curl -X GET https://api.sandbox.transferwise.tech/v1/rates?source=EUR&target=USD \
     -H 'Authorization: Bearer <your api token>'

Example Request (Basic authentication)

curl -X GET https://api.sandbox.transferwise.tech/v1/rates?source=EUR&target=USD \
     --user <your api client_id>:<your api client_secret>

Example Response

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