Bidders - Currency サービス
警告
API Currency Service は、Xandr プラットフォームを介した取引の結果として支払われた金額または受け取った金額を調整するためだけにクライアントが利用でき、クライアントが他の目的で使用することはできません。
これは、使用する行項目または挿入順序を設定できる通貨の一覧を示す読み取り専用サービスです。
買い側入札者のオープンRTBの場合、入札者に対する送信入札要求で米ドル以外の通貨を送信し、応答で他の通貨を受け入れます。 入札者が入札の通貨を変更するには、フィールドを送信する "cur"
必要があります。 フィールドが "cur"
指定されていない場合、既定値は USD になります。 入札者は、既定の通貨で設定されている値に関係なく、任意の通貨で応答できます。 フィールドに通貨を示すだけで、追加の "cur"
有効化は必要ありません。
売り側 Open RTB の場合、既定では USD が通貨として使用され、 "cur"
フィールドは無視されます。 販売者メンバーが明示的に設定するための seller_bid_currency
メンバー資格を持っている場合は、 "cur"
入札要求のフィールドが尊重されます。
為替レートは、Oanda から毎日午前 3 時 (UTC) に 1回提供されます。
HTTP メソッド | エンドポイント | 説明 |
---|---|---|
GET |
https://api.appnexus.com/currency |
使用可能なすべての通貨を表示する |
GET |
https://api.appnexus.com/currency?code=CURRENCY_CODE |
特定の通貨を表示する |
GET |
https://api.appnexus.com/currency?code=CURRENCY_CODE&show_rate=true |
今日の通貨の為替レートを表示する |
GET |
https://api.appnexus.com/currency?show_rate=true&code=CURRENCY_CODE&ymd=2012-03-01 |
過去 1 日の通貨の為替レートを表示する |
フィールド | 型 | 説明 |
---|---|---|
as_of |
string | Oanda が最後に UTC で為替レートを更新した日時。 Oanda から毎日午前 3 時 (UTC) に料金を引き出します。 これは、クエリ文字列を渡 show_rate=true す場合にのみ返されます。 |
code |
string | 通貨のコード。 |
description |
string | 通貨の説明。 |
is_exposed |
ブール値 | の場合 true 、通貨が公開されます。 |
last_modified |
string | 通貨が最後に変更された日時。 ( 注 *) を参照してください。 |
name |
string | 通貨の完全な名前。 |
position |
列挙 | 通貨記号が金額の前後に表示されるかどうか。 使用可能な値: "before" または "after" 。 |
rate_per_usd |
double | 為替レート。 これは、クエリ文字列を渡 show_rate=true す場合にのみ返されます。 |
symbol |
string | 通貨の記号 (例: 米ドルの場合は "$" ) |
コンバージョン率を表示するには、URL を渡します show_rate=true
。 URL を使用して渡 ymd=YYYYMMDD
すことで、過去 1 日のレートを取得することもできます。
注意
*通貨 API (例: rate_per_usd
) に対してクエリを実行する場合、サービスは現在、すべての正しい値を返しています。ただし、 は例外 last_modified
です。 実際のレートは正確であり、API は更新された為替レートを返しています。 現在、返される as_of
為替レートの last_modified
バージョンを把握する代わりに、 列を使用します。
使用可能なすべての通貨を表示する
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
}
}
2020 年 3 月 1 日の EUR 為替レートを表示する
$ 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
}
}