Exchange Rate Service

The exchange rate service allows you to convert USD revenue measures in your client audit logs into local currency. You can use the API endpoint listed below to get daily exchange rates used during IX auctions for converting foreign currencies to USD.

Note: We may use a different exchange rate for publisher payout based on contractual obligation with the publisher.

This service returns all currencies and daily exchange rates used in the last 14 days. You can choose to filter to only see the exchange rate for a particular day and currency. Your request must use the following format:

Request Parameter Value
Type GET
Resource exchange_rates
Header Authorization: Bearer <access_token>
Query String date=<date>
Query String currency=<3 digit currency code>

In the header, <access_token> is the access token you received from the response during authentication.

The following is a sample call:

curl https://app.indexexchange.com/api/cal/v1/exchange-rates -H "Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCIgOiAiSldUIiwia2lkIiA6ICJQTVhhU2F5TVhxeWhfQVFSX0RSdThfNEFodDcwVTVjNFBMa2J6VGhCa04wIn0.eyJqdGkiOiJlYzY3ZTY4OS0zNDMwLTQ3ZGEtOTlhMS02Y2ZjOTFlM2ZhNTYiLCJleHAiOjE1MzkxMTQ0MzAsIm5iZiI6MCwiaWF0IjoxNTM5MTEwODMwLCJpc3MiOiJodHRwczovL2lkZW50aXR5LXRlc3QuaW5kZXhleGNoYW5nZS5jb20vYXV0aC9yZWFsbXMvZXZlbnRsb2ciLCJhdWQiOiJ0ZXN0LW1lcmtsZS1jbGllbnQiLCJzdWIiOiIwODA2MWU4OS05ODE3LTQ5NDgtYThmMC03ZTgyODk1ZTdlNGQiLCJ0eXAiOiJCZWFyZXIiLCJhenAiOiJ0ZXN0LW1lcmtsZS1jbGllbnQiLCJhdXRoX3RpbWUiOjAsInNlc3Npb25fc3RhdGUiOiI3ZjlkNWVmZC02OTkzLTQyMTgtOTZkNy1mZjUxZmEyMDE3YzMiLCJhY3IiOiIxIiwiYWxsb3dlZC1vcmlnaW5zIjpbXSwicmVhbG1fYWNjZXNzIjp7InJvbGVzIjpbInVtYV9hdXRob3JpemF0aW9uIl19LCJyZXNvdXJjZV9hY2Nlc3MiOnsidGVzdC1tZXJrbGUtY2xpZW50Ijp7InJvbGVzIjpbInVtYV9wcm90ZWN0aW9uIl19LCJhY2NvdW50Ijp7InJvbGVzIjpbIm1hbmFnZS1hY2NvdW50IiwibWFuYWdlLWFjY291bnQtbGlua3MiLCJ2aWV3LXByb2ZpbGUiXX19LCJldmVudExvZ0NsaWVudElkIjoiMTIiLCJjbGllbnRJZCI6InRlc3QtbWVya2xlLWNsaWVudCIsImNsaWVudEhvc3QiOiIxMC4yMzMuNzMuOTMiLCJwcmVmZXJyZWRfdXNlcm5hbWUiOiJzZXJ2aWNlLWFjY291bnQtdGVzdC1tZXJrbGUtY2xpZW50IiwiY2xpZW50QWRkcmVzcyI6IjEwLjIzMy43My45MyIsImVtYWlsIjoic2VydmljZS1hY2NvdW50LXRlc3QtbWVya2xlLWNsaWVudEBwbGFjZWhvbGRlci5vcmcifQ.J9AXq_S_oemRmiAXPvmKvH0OokeQ0Oi8HcX2H_wy7shl7JTpfTttl6NsR1MpcnKjDtJRW1d-IBmQdGrD2y58T74ZPnsPHFVuW_Euj2xJwZf0T5rI_N8K8cL9o6mZfHQc0dTFCMdxzZM0n0QU3pli6yB_I8Gt7GDGaIsgO6jjF8ovN-7WMGGu9WJ0q4d1gzdWkYa8gzE1EwEUWAsQokZZ20ZRoLGbwmyzQ5EeXaz0UJapACvY9qmjdDl0zldn5XxTkqzkWCdhw11J514Ju5IzkRH7pBc5ky5frhKP52dzRF9r9f0rTDJpYWWiAldX1ceJRbMULyfS9EUi9oE1mSWMoQ"
200 OK
{
    data:   [
        {
            "base": "USD",
            "date": "2019-04-27",
            "rates": [
                {
                    "currency": "AUD",
                    "rate": 1.05
                },
                {
                    "currency": "CAD",
                    "rate": 1.37
                }
                     ]
        },
        {
            "base": "USD",
            "date": "2019-04-28",
            "rates": [
                {
                    "currency": "AUD",
                    "rate": 1.07
                },
                {
                    "currency": "CAD",
                    "rate": 1.34
                }
                     ]
        },
            ]
}

The following sample call contains query parameters (date and currency) to filter output:

curl https://app.indexexchange.com/api/cal/v1/exchange-rates?date=2017-10-27&currency=CAD -H "Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCIgOiAiSldUIiwia2lkIiA6ICJQTVhhU2F5TVhxeWhfQVFSX0RSdThfNEFodDcwVTVjNFBMa2J6VGhCa04wIn0.eyJqdGkiOiJlYzY3ZTY4OS0zNDMwLTQ3ZGEtOTlhMS02Y2ZjOTFlM2ZhNTYiLCJleHAiOjE1MzkxMTQ0MzAsIm5iZiI6MCwiaWF0IjoxNTM5MTEwODMwLCJpc3MiOiJodHRwczovL2lkZW50aXR5LXRlc3QuaW5kZXhleGNoYW5nZS5jb20vYXV0aC9yZWFsbXMvZXZlbnRsb2ciLCJhdWQiOiJ0ZXN0LW1lcmtsZS1jbGllbnQiLCJzdWIiOiIwODA2MWU4OS05ODE3LTQ5NDgtYThmMC03ZTgyODk1ZTdlNGQiLCJ0eXAiOiJCZWFyZXIiLCJhenAiOiJ0ZXN0LW1lcmtsZS1jbGllbnQiLCJhdXRoX3RpbWUiOjAsInNlc3Npb25fc3RhdGUiOiI3ZjlkNWVmZC02OTkzLTQyMTgtOTZkNy1mZjUxZmEyMDE3YzMiLCJhY3IiOiIxIiwiYWxsb3dlZC1vcmlnaW5zIjpbXSwicmVhbG1fYWNjZXNzIjp7InJvbGVzIjpbInVtYV9hdXRob3JpemF0aW9uIl19LCJyZXNvdXJjZV9hY2Nlc3MiOnsidGVzdC1tZXJrbGUtY2xpZW50Ijp7InJvbGVzIjpbInVtYV9wcm90ZWN0aW9uIl19LCJhY2NvdW50Ijp7InJvbGVzIjpbIm1hbmFnZS1hY2NvdW50IiwibWFuYWdlLWFjY291bnQtbGlua3MiLCJ2aWV3LXByb2ZpbGUiXX19LCJldmVudExvZ0NsaWVudElkIjoiMTIiLCJjbGllbnRJZCI6InRlc3QtbWVya2xlLWNsaWVudCIsImNsaWVudEhvc3QiOiIxMC4yMzMuNzMuOTMiLCJwcmVmZXJyZWRfdXNlcm5hbWUiOiJzZXJ2aWNlLWFjY291bnQtdGVzdC1tZXJrbGUtY2xpZW50IiwiY2xpZW50QWRkcmVzcyI6IjEwLjIzMy43My45MyIsImVtYWlsIjoic2VydmljZS1hY2NvdW50LXRlc3QtbWVya2xlLWNsaWVudEBwbGFjZWhvbGRlci5vcmcifQ.J9AXq_S_oemRmiAXPvmKvH0OokeQ0Oi8HcX2H_wy7shl7JTpfTttl6NsR1MpcnKjDtJRW1d-IBmQdGrD2y58T74ZPnsPHFVuW_Euj2xJwZf0T5rI_N8K8cL9o6mZfHQc0dTFCMdxzZM0n0QU3pli6yB_I8Gt7GDGaIsgO6jjF8ovN-7WMGGu9WJ0q4d1gzdWkYa8gzE1EwEUWAsQokZZ20ZRoLGbwmyzQ5EeXaz0UJapACvY9qmjdDl0zldn5XxTkqzkWCdhw11J514Ju5IzkRH7pBc5ky5frhKP52dzRF9r9f0rTDJpYWWiAldX1ceJRbMULyfS9EUi9oE1mSWMoQ"
200 OK
{
    data:   [
        {
            "base": "USD",
            "date": "2017-10-27",
            "rates": [
                {
                    "currency": "CAD",
                    "rate": 1.12
                }
                     ]
        }
            ]
}

See the JSON field definitions below for more details about the fields in the response:

Field

Description
base Base currency ("USD").
currency The currency to which base currency is converted, for example "CAD".
date The date for the exchange rate, for example "2019-05-17".
rate The exchange rate used for conversion, for example "1.04".
rates An object that contains the currency and exchange rate for the given date.