Get exchange rates

We offer international rewards at Tango in over 80 different countries and their local currencies. The foreign exchange rate is calculated daily using multiple sources depending on the brand and location. Using the day’s currency exchange rate, we convert the reward's currency to your account’s default currency. We present the amount that will be charged to your account at the time of order.

At Tango we offer currency functionality in USD, CAD, EUR, and GBP. When you create an account, you are able to set the currency you would like to transact in.

📘

Note:

  • We only accept CAD, EUR, GBP, or USD.
  • Only one currency can be specified. The currency of a Tango account is set at the time the account is created, and can't be changed after any transactions have been made on the account. The currency defaults to USD if no currency is specified.
  • You can only change currency on an account that doesn’t have any transactions. If transactions have already occurred, a new account will have to be created reflecting the requested currency.
  • Completed transactions are final. Once a transaction is complete, its currency cannot be exchanged for another currency.
  • Exchange rates are updated once per day starting at 12:00 UTC and no later than +13:00 UTC.

Get a list of exchange rates

Use the following endpoint to get a list of exchange rates available for your platform.

EndpointPurpose
GET {URI}/exchangeratesGet a list of Exchange Rates.

The following query parameters help you narrow down your search with this endpoint. You can query exchange rates for your base currency or reward currency. For example, enter your base currency such as USD, and get the conversion rate for EUR. Paginate the results to filter the payload.

Query paramsData typeDescription
paginate (🚧 coming soon)booleanWhether to paginate the results or not.
-true: paginates the results
-false: doesn't paginate the results. Paginate defaults to false.
prevCursorstringThe cursor to use for the previous page of results. This will be ignored if paginate is false.
nextCursorstringThe cursor to use for the next page of results. This will be ignored if paginate is false.
maxResultsstringThe maximum number of results to return. The default is 10, and the maximum is 200. This will be ignored if paginate is false.
baseCurrencyarray of stringsReturns all exchange rates for a specific base currency. (optional)
This field is case-sensitive.
rewardCurrencyarray of stringsReturns all exchange rates for a specific reward currency. (optional)
This field is case-sensitive.

The following payload example shows the exchange rate for when your account's base currency is USD and you would like to see the conversion rate to Euro currency EUR for the reward. The value you enter in the currency field is case sensitive:

{
  "disclaimer": "Exchange rates are provided here for reference. They are updated at least once a day and may have changed by time of order.",
  "exchangeRates": [
    {
      "lastModifiedDate": "2025-02-12T13:01:52.538Z",
      "rewardCurrency": "EUR",
      "baseCurrency": "USD",
      "baseFx": 0.96381
    }
  ]
}

The following payload example shows the pagination payload: (🚧 coming soon)

{
  "prevCursor": null,
  "nextCursor": null,
  "prevPageAvailable": false,
  "nextPageAvailable": false,
  "maxResults": 10,
  "disclaimer": "string",
  "exchangeRates": [
    {
      "lastModifiedDate": "2023-01-23T20:12:42.136Z",
      "rewardCurrency": "string",
      "baseCurrency": "string",
      "baseFx": 0
    }
  ]
}

The possible response codes for this endpoint are:

  • 200 OK
  • 400 Bad Request
  • 401 Unauthorized
  • 403 Forbidden

Rewards as a Service™ and the RaaS® API are provided by Tango Card, Inc. © 2024 Tango Card, Inc.