Licitadores: servicio de moneda

Advertencia

El servicio de moneda de API está disponible para los clientes únicamente para conciliar los importes pagados o recibidos por ellos resultantes de sus transacciones a través de la Plataforma Xandr y no pueden ser utilizados por los clientes para ningún otro propósito.

Se trata de un servicio de solo lectura que muestra la lista de monedas que puede establecer para usar un elemento de línea o un orden de inserción.

En el caso de open RTB de compra para licitadores, puede enviar monedas distintas de USD en la solicitud de oferta saliente a los licitadores y aceptar otras monedas en la respuesta. Para que un licitador cambie la moneda de su oferta, debe enviar el "cur" campo. Si no se especifica el "cur" campo, el valor predeterminado será USD. Un pujador puede responder con cualquier moneda, independientemente del valor que se establezca en la moneda predeterminada. Solo necesitan indicar la moneda en el "cur" campo y no se requiere ninguna habilitación adicional.

En el caso de open RTB de venta, de forma predeterminada, se usa USD como moneda en la que se omite el "cur" campo. Si el miembro del vendedor tiene un derecho de miembro para seller_bid_currency configurar explícitamente, se respeta el "cur" campo en las solicitudes de puja.

Las tasas de cambio se obtienen una vez al día desde Oanda aproximadamente a las 3:00 a.m. UTC.

API de REST

Http (método)	Endpoint	Description
GET	https://api.appnexus.com/currency	Ver todas las monedas disponibles
GET	https://api.appnexus.com/currency?code=CURRENCY_CODE	Visualización de una moneda específica
GET	https://api.appnexus.com/currency?code=CURRENCY_CODE&show_rate=true	Ver el tipo de cambio de una moneda para hoy
GET	https://api.appnexus.com/currency?show_rate=true&code=CURRENCY_CODE&ymd=2012-03-01	Ver el tipo de cambio de una moneda durante un día en el pasado

Campos JSON

Fields	Tipo	Descripción
as_of	string	Fecha y hora en que Oanda actualizó por última vez el tipo de cambio en UTC. Extraemos las tarifas de Oanda todos los días a las 3:00 a.m. UTC. Esto solo se devuelve cuando se pasa show_rate=true la cadena de consulta.
code	string	Código de la moneda.
description	string	Descripción de la moneda.
is_exposed	booleano	Si truees , se expone la moneda.
last_modified	string	Fecha y hora en que se modificó la moneda por última vez. (Ver nota *)
name	string	Nombre completo de la moneda.
position	enumeración	Si el símbolo de moneda aparece antes o después del importe. Valores posibles: "before" o "after".
rate_per_usd	double	Tipo de cambio. Esto solo se devuelve cuando se pasa show_rate=true la cadena de consulta.
symbol	string	Símbolo de la moneda, por ejemplo, "$" para USD

Para mostrar las tasas de conversión, pase show_rate=true la dirección URL. También puede recuperar la tasa de un día pasado pasando ymd=YYYYMMDD a través de la dirección URL.

Nota:

*Al consultar la API de moneda (por ejemplo, rate_per_usd), el servicio devuelve actualmente todos los valores correctos, con la excepción de last_modified. Las tasas reales son precisas y la API devuelve los tipos de cambio actualizados. Actualmente, use la as_of columna en lugar de last_modified para conocer la versión del tipo de cambio que se devuelve.

Ejemplos

Ver todas las monedas disponibles

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

Ver el tipo de cambio eur el 1 de marzo de 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
    }
}