Affiliates Integration Guide

API access

Once you become our affiliate partner, please get in touch with our team at partnerwise@wise.com. We will review your request and send over instructions on how to get the API access credentials.

There are two endpoints Exchange Rates.List and Get Temporary Quote which you can call with this authentication method.

Postman Collection

Please visit our Postman collection for more details and examples of how to use our API, including how to get comparison, rates as well as pricing and speed data.

TEST and LIVE environments

  • Sandbox API is located at https://api.sandbox.transferwise.tech
  • LIVE API is located at https://api.transferwise.com

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:

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 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"
  }
]
Full reference

Get pricing and speed

POST https://api.sandbox.transferwise.tech/v2/quotes

Is currency route supported?

If we don't support a route then this endpoint will respond with an error code "error.route.not.supported".

How much does a transfer cost?

The Wise fee is included in the response.

How long does my transfer take?

Estimated delivery time is included in the response. This can vary quite a lot for different currency routes. For example transfers often only take a few hours from EUR to GBP, while sending money from USD can take 1-2 business days. This endpoint allows you to find out the estimated delivery time for each currency route.

See more at Creating Temporary Quote

Example Request
curl -X POST https://api.sandbox.transferwise.tech/v2/quotes \
    --header 'Content-Type: application/json' \
    --data-raw '{"targetCurrency":"GBP","targetAmount":600,"sourceCurrency":"EUR"}' \
    --user <your api client_id>:<your api client_secret>
Example Response
{
  "sourceCurrency": "EUR",
  "targetCurrency": "GBP",
  "targetAmount": 600,
  "clientId": "unknown",
  "createdTime": "2022-10-25T10:03:22Z",
  "expirationTime": "2022-10-25T10:33:22Z",
  "funding": "POST",
  "guaranteedTargetAmount": false,
  "guaranteedTargetAmountAllowed": true,
  "notices": [],
  "payOut": "BANK_TRANSFER",
  "paymentOptions": [
    {
      "allowedProfileTypes": ["PERSONAL", "BUSINESS"],
      "disabled": false,
      "estimatedDelivery": "2022-10-25T10:03:22Z",
      "estimatedDeliveryDelays": [],
      "feePercentage": 0.0048,
      "formattedEstimatedDelivery": "in seconds",
      "payIn": "BANK_TRANSFER",
      "payInProduct": "CHEAP",
      "payOut": "BANK_TRANSFER",
      "price": {
        "items": [
          {
            "type": "TRANSFERWISE",
            "label": "Our fee",
            "value": {
              "amount": 3.32,
              "currency": "EUR",
              "label": "3.32 EUR"
            },
            "priceSetId": 132,
            "total": {
              "type": "TOTAL",
              "label": "Total fees",
              "value": {
                "amount": 3.32,
                "currency": "EUR",
                "label": "3.32 EUR"
              }
            }
          }
        ]
      },
      "sourceAmount": 691.85,
      "sourceCurrency": "EUR",
      "targetAmount": 600,
      "targetCurrency": "GBP"
    }
  ],
  "providedAmountType": "TARGET",
  "rate": 0.871426,
  "rateExpirationTime": "2022-10-27T14:59:59Z",
  "rateTimestamp": "2022-10-25T10:02:42Z",
  "rateType": "FIXED",
  "status": "PENDING",
  "targetAmountAllowed": true,
  "type": "REGULAR"
}