Rate

Current and historical exchange rates by currency routes.

Endpoints
GET/v1/rates
GET/v1/rates?source=EUR&target=USD
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"
}
Please note that the from, to, and group parameters are not testable in our Sandbox environment at this time.

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.

This endpoint only supports Bearer authentication for non-Affiliate partners.

Request

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:

FieldSample
from2019-03-13T14:53:01 or 2019-03-13
to2019-03-13T14:53:01+0100 or 2019-03-13+0100

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

FieldSample
time2019-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 Response
[
{
"rate": 1.166,
"source": "EUR",
"target": "USD",
"time": "2018-08-31T10:43:31+0000"
}
]