Digital Platform API - 通貨サービス

警告

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

これは、使用するラインアイテムまたは広告掲載オーダーを設定できる通貨のリストを表示する読み取り専用サービスです。

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

注:

為替レートは、1 日 1 回午前 3:00 頃 (UTC) にリフィニティブから取得されます。

JSON フィールド

フィールド	型	説明
`as_of`	string	Refinitiv が最後に為替レートを更新した日時 (UTC)。 Refinitivからレートは UTC 午前 3:00 頃に取得します。これは、クエリ文字列で `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.appnexus.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
            },
            {
                "code": "CAD",
                "symbol": "CDN$",
                "name": "Canadian Dollar (CAD)",
                "description": null,
                "position": "before",
                "last_modified": "2010-08-24 19:29:04",
                "is_exposed": true
            },
            {
                "code": "CNY",
                "symbol": "元",
                "name": "Chinese Yuan (CNY)",
                "description": null,
                "position": "before",
                "last_modified": "2010-08-16 23:07:23",
                "is_exposed": true
            },
                        ...
        ],
        "count": 17,
        "start_element": null,
        "num_elements": null
    }
}

2024 年 1 月 2 日のユーロの為替レートを見る

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

Last updated on 2026-08-18