API de plataforma digital: servicio de moneda

Advertencia

El Servicio de Moneda API está disponible para los clientes únicamente para conciliar los montos pagados o recibidos por ellos como resultado de sus transacciones a través de la Plataforma Xandr y no puede ser utilizado 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 que use un elemento de línea o un orden de inserción.

API de REST

Método HTTP Endpoint Description
GET https://api.appnexus.com/currency Ver todas las monedas disponibles
GET https://api.appnexus.com/currency?code=CURRENCY_CODE Ver una moneda específica
GET https://api.appnexus.com/currency?code=CURRENCY_CODE&show_rate=true Ver el tipo de cambio de una divisa 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 divisa de un día en el pasado

Nota:

Los tipos de cambio se obtienen una vez al día de Refinitiv, aproximadamente a las 3:00 a.m. UTC.

Campos JSON

Fields Tipo Descripción
as_of string La fecha y hora en que Refinitiv actualizó por última vez el tipo de cambio en UTC. Obtenemos las tarifas de Refinitivaproximadamente a las 3:00 a.m. UTC. Esto se devuelve solo cuando se pasa show_rate=true la cadena de consulta. 
code string El código de la moneda.
description string Una descripción de la moneda.
is_exposed booleano Si true, la moneda está expuesta.
last_modified string La fecha y hora en que se modificó por última vez la moneda. (Ver nota *)
name string El 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 El tipo de cambio. Esto se devuelve solo cuando se pasa show_rate=true la cadena de consulta.
symbol string El símbolo de la moneda, por ejemplo, del USD. "$"

Nota:

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

  • * Al consultar la API de moneda (por ejemplo: rate_per_usd), el servicio devuelve todos los valores correctos, con la excepción last_modifiedde . Las tasas reales son precisas y la API devuelve tasas de cambio actualizadas.

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

Ver el tipo de cambio del EUR el 2 de enero de 2024

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