Leer en inglés

Compartir a través de


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