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.
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 |
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.
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
}
}