英語で読む

次の方法で共有


Bidders - Currency サービス

警告

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

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

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

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

為替レートは、Oanda から毎日午前 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 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
    }
}