Convertidor de precio ADR a acción ordinaria
Un certificado de depósito agrupa un número fijo de acciones ordinarias extranjeras, por lo que su precio nunca coincide con el de la acción en su mercado de origen: entre ambos se interponen la ratio de conversión y el tipo de cambio.
Ejecutar — gratis
Esta API toma el precio del certificado, la ratio y el tipo de cambio, y devuelve el precio equivalente de una acción ordinaria en su divisa local: la cifra que necesita para comparar el certificado con la cotización original y detectar una prima o un descuento.
Por qué el precio del certificado nunca es el de la acción
Cuando una empresa extranjera cotiza en Estados Unidos, un banco depositario crea certificados que representan cada uno un número determinado de acciones ordinarias: a veces una fracción de acción, a veces diez o cincuenta. Además de ese empaquetado, el certificado cotiza en dólares mientras las acciones ordinarias lo hacen en libras, yenes o euros. Dos inversores que miran la misma empresa ven, por tanto, dos cifras completamente distintas en sus pantallas, y ninguna de las dos es incorrecta. Para saber si el ADR está caro o barato respecto a la cotización de origen hay que deshacer ambos efectos: dividir entre la ratio para obtener el valor por acción individual y convertir las divisas para expresar ambos precios en la misma unidad. Este endpoint realiza exactamente esa aritmética en una sola llamada, sin sorpresas de redondeo, de modo que un filtro de valores, un monitor de arbitraje o una simple hoja de cálculo puedan poner ambos mercados uno junto al otro y comparar lo comparable.
La fórmula y el significado de cada entrada
La conversión es una sola línea: el precio de la acción es igual al precio del certificado multiplicado por el tipo de cambio y dividido entre la ratio. <code>adr_price</code> es el último precio negociado de un certificado en su divisa de cotización. <code>ratio</code> indica cuántas acciones ordinarias representa un certificado: una ratio de 0.5 significa dos certificados por acción, y una ratio de 5 significa que un certificado agrupa cinco acciones. <code>exchange_rate</code> se expresa como divisa del certificado por unidad de la divisa local: si el certificado cotiza en dólares y las acciones en libras, es el número de dólares por libra. El tipo de cambio debe ser positivo, porque un tipo cero o negativo nunca es una cotización real y casi siempre delata un error de datos aguas arriba; el endpoint lo rechaza en lugar de devolver un cero engañoso. El resultado se redondea por defecto a seis decimales, y puede pedir entre cero y doce.
Cómo usar el resultado sin engañarse
La salida es el precio teórico equivalente de una acción ordinaria en su divisa local, dados los datos que usted ha introducido. Que el certificado cotice de verdad con prima o con descuento es otra cuestión: compare el valor devuelto con la cotización en vivo del mercado de origen y recuerde que ambos mercados pueden no estar abiertos al mismo tiempo, de modo que los precios comparados pueden corresponder a momentos distintos. Las comisiones, el tratamiento de los dividendos y los impuestos locales hacen además que la paridad teórica rara vez se alcance al céntimo. Nada de eso es tarea de esta herramienta: realiza deliberadamente un único cálculo determinista y lo hace con exactitud, igual en su navegador que a través de la API de pago, de modo que pueda prototipar la comparación a mano y automatizarla, por $0.002 por solicitud, solo cuando las cifras tengan sentido. Todo se ejecuta en nuestro edge global y nada de lo que envíe se almacena después de devolver la respuesta.
Qué puede hacer con ella
Compare el certificado con la cotización de origen
Convierta la cotización del ADR al precio de la acción en divisa local y vea de un vistazo si el certificado cotiza con prima o con descuento.
Alimente un monitor de arbitraje
Calcule los precios de paridad en bloque sobre su lista de seguimiento y marque los pares cuya diferencia supere su umbral.
Explique la ratio a un cliente
Muestre por qué un certificado de 25 dólares corresponde a una acción con un precio muy superior o inferior una vez aplicadas la ratio y la divisa.
Preguntas frecuentes
¿Cuánto cuesta?
$0.002 por solicitud a través de la API. También es gratis ejecutarlo en su navegador en esta misma página.
¿Qué es exactamente la ratio?
El número de acciones ordinarias que representa un certificado de depósito. Una ratio de 0.5 significa dos certificados por acción; una ratio de 5 significa que un certificado agrupa cinco acciones.
¿Cómo se expresa el tipo de cambio?
Como divisa del certificado por unidad de la divisa local de la acción. Si el certificado cotiza en USD y las acciones en GBP, son los dólares por libra.
¿Por qué se ha rechazado mi entrada?
El tipo de cambio y la ratio deben ser positivos, y el precio del certificado no puede ser negativo. Un tipo cero o negativo nunca es una cotización real, así que el endpoint lo trata como un error de datos.
¿Devuelve el valor justo del certificado?
No. Devuelve el precio equivalente de la acción ordinaria para el precio de certificado que usted ha indicado. Si eso implica prima o descuento es algo que debe juzgar frente a la cotización en vivo del mercado de origen.
¿Cuántos decimales tiene el resultado?
Seis por defecto, ajustables de cero a doce con el campo decimals.
Para desarrolladores — acceso por API
Todo lo de esta página está disponible por programación. Esta sección es para equipos que quieren integrarlo en sus sistemas; el resto puede usar la herramienta de arriba sin más.
Endpoint de API
¿Prefiere automatizarlo? Un POST autenticado crea la tarea; el resultado llega por webhook o enlace firmado. La misma capacidad también se ejecuta aquí en la web, por email y desde Telegram — y pronto también desde nuestra app.
Llámela desde su stack
curl -X POST https://api.kit.forhosting.com/fin/adr \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"adr_price":25.5,"ratio":0.5,"exchange_rate":1.27}'const res = await fetch("https://api.kit.forhosting.com/fin/adr", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"adr_price": 25.5,
"ratio": 0.5,
"exchange_rate": 1.27
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/fin/adr",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"adr_price": 25.5,
"ratio": 0.5,
"exchange_rate": 1.27
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/fin/adr", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"adr_price":25.5,"ratio":0.5,"exchange_rate":1.27}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"adr_price":25.5,"ratio":0.5,"exchange_rate":1.27}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/fin/adr", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Ejemplo de solicitud
{
"adr_price": 25.5,
"ratio": 0.5,
"exchange_rate": 1.27
}Ejemplo de respuesta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "fin.adr",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}La API es asíncrona: la llamada devuelve un task_id al instante y el resultado llega por webhook. El polling está limitado a 1 req/s por tarea.
Precio
Precio publicado — sin tokens ni créditos inventados. Una tarea fallida no se cobra.
Errores
| HTTP | Código | Significado |
|---|---|---|
401 | unauthorized | API key ausente o inválida. |
402 | insufficient_balance | El saldo no cubre el precio de la tarea. |
404 | unknown_type | El tipo de tarea no existe. |
429 | rate_limited | Demasiadas peticiones. Use el webhook en vez de sondear. |