Bidders - Currency service

Warning

The API Currency Service is available to clients solely to reconcile amounts paid or received by them resulting from their transactions through the Xandr Platform and may not be used by clients for any other purpose.

This is a read-only service that shows you the list of currencies that you can set a line-item or insertion-order to use.

For buy side Open RTB for bidders, you can send currencies other than USD in the outgoing bid request to bidders and accept other currencies in the response. In order for a bidder to change currency of their bid, they must send the "cur" field. If the "cur" field is not specified, it will be defaulted to USD. A bidder can respond with any currency, regardless of what value is set in the default currency. They just need to indicate the currency in the "cur" field and no additional enablement is required.

For sell side Open RTB, by default USD is used as currency where the "cur" field is ignored. If the seller member has a member entitlement for seller_bid_currency explicitly set up, the "cur" field in bid requests is respected.

Exchange rates are sourced once daily from Oanda at approximately 3:00 a.m. UTC.

REST API

HTTP Method	Endpoint	Description
GET	https://api.appnexus.com/currency	View all available currencies
GET	https://api.appnexus.com/currency?code=CURRENCY_CODE	View a specific currency
GET	https://api.appnexus.com/currency?code=CURRENCY_CODE&show_rate=true	View a currency's exchange rate for today
GET	https://api.appnexus.com/currency?show_rate=true&code=CURRENCY_CODE&ymd=2012-03-01	View a currency's exchange rate for a day in the past

JSON fields

Fields	Type	Description
as_of	string	The date and time that Oanda last updated the exchange rate in UTC. We pull the rates from Oanda every day at 3:00 a.m. UTC. This is returned only when you pass show_rate=true in the query string.
code	string	The code for the currency.
description	string	A description of the currency.
is_exposed	boolean	If true, the currency is exposed.
last_modified	string	The date and time when the currency was last modified. (See Note *)
name	string	The full name of the currency.
position	enum	Whether the currency symbol appears before or after the amount. Possible values: "before" or "after".
rate_per_usd	double	The exchange rate. This is returned only when you pass show_rate=true in the query string.
symbol	string	The symbol for the currency, e.g. "$" for USD

To show conversion rates, pass show_rate=true in the URL. You can also retrieve a past day's rate by passing in ymd=YYYYMMDD via the URL.

Note

*When querying the currency API (eg: rate_per_usd), the service is currently returning all the correct values, with the exception for last_modified. The actual rates are accurate, and the API is returning updated exchange rates. Currently, use the as_of column instead of last_modified to know the version of the exchange rate being returned.

Examples

View all available currencies

curl -b cookies -c cookies 'https://api.adnxs.com/currency'
{
    "response": {
        "status": "OK",
        "currencies": [
            {
                "code": "ARS",
                "symbol": "₱",
                "name": "Argentine Peso (ARS)",
                "description": null,
                "position": "before",
                "last_modified": "2010-08-16 23:07:23",
                "is_exposed": true
            },
            {
                "code": "AUD",
                "symbol": "AUD$",
                "name": "Australian Dollar (AUD)",
                "description": null,
                "position": "before",
                "last_modified": "2010-08-24 19:29:04",
                "is_exposed": true
            },
            {
                "code": "BRL",
                "symbol": "R$",
                "name": "Brazilian Real (BRL)",
                "description": null,
                "position": "before",
                "last_modified": "2010-08-16 23:07:23",
                "is_exposed": true
            }
                        ...
        ],
        "count": 17,
        "start_element": null,
        "num_elements": null
    }
}

View the EUR exchange rate on March 1, 2020

$ curl -b cookies -c cookies  'https://api.adnxs.com/currency?show_rate=true&code=EUR&ymd=2020-03-01'
{
    "response": {
        "status": "OK",
        "currency": {
            "code": "EUR",
            "symbol": "€",
            "name": "Euro (EUR)",
            "description": null,
            "position": "before",
            "last_modified": "2020-02-16 23:07:23",
            "rate_per_usd": 0.7506,
            "as_of": "2020-03-01 11:24:00",
            "is_exposed": true
        },
        "count": 1,
        "start_element": null,
        "num_elements": null
    }
}