次の方法で共有

Bidders - Currency サービス

警告

API Currency Service は、Xandr プラットフォームを介した取引の結果として支払われた金額または受け取った金額を調整するためだけにクライアントが利用でき、クライアントが他の目的で使用することはできません。

これは、使用する行項目または挿入順序を設定できる通貨の一覧を示す読み取り専用サービスです。

買い側入札者のオープンRTBの場合、入札者に対する送信入札要求で米ドル以外の通貨を送信し、応答で他の通貨を受け入れます。 入札者が入札の通貨を変更するには、 "cur" フィールドを送信する必要があります。 "cur" フィールドが指定されていない場合、既定値は USD になります。 入札者は、既定の通貨で設定されている値に関係なく、任意の通貨で応答できます。 "cur"フィールドに通貨を示すだけで、追加の有効化は必要ありません。

売り側 Open RTB の場合、既定では USD が通貨として使用され、 "cur" フィールドは無視されます。 販売者メンバーが明示的に設定 seller_bid_currency メンバー資格を持っている場合、入札要求の "cur" フィールドが尊重されます。

為替レートは、リファイニティフから毎日午前 3 時 (UTC) に 1回提供されます。

REST API

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 日の通貨の為替レートを表示する

JSON フィールド

フィールド 型 説明
as_of string Refinitiv が最後に UTC で為替レートを更新した日時。 リファイニティフから毎日午前 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 は更新された為替レートを返しています。 現在、last_modifiedではなくas_of列を使用して、返される為替レートのバージョンを把握します。

例

使用可能なすべての通貨を表示する

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
    }
}
  • Last updated on