ForHosting KIT · Ferramentas para dev

Conversor de preço ADR para ação ordinária

Um certificado de depósito reúne um número fixo de ações ordinárias estrangeiras, por isso o seu preço nunca coincide com o da ação no mercado de origem: entre os dois estão a razão de conversão e a taxa de câmbio.

● BetaGrátis · no seu navegador
Use pelo WebAPIE-mailTelegramApp em breve

Esta API recebe o preço do certificado, a razão e a taxa de câmbio, e devolve o preço equivalente de uma ação ordinária na sua moeda local: o número de que você precisa para comparar o certificado com a cotação original e identificar um prêmio ou um desconto.

Por que o preço do certificado nunca é o da ação

Quando uma empresa estrangeira lista-se nos Estados Unidos, um banco depositário cria certificados que representam, cada um, um número determinado de ações ordinárias: às vezes uma fração de ação, às vezes dez ou cinquenta. Além desse empacotamento, o certificado é negociado em dólares enquanto as ações ordinárias são negociadas em libras, ienes ou euros. Dois investidores olhando para a mesma empresa veem, portanto, dois números completamente diferentes em suas telas, e nenhum dos dois está errado. Para saber se o ADR está caro ou barato em relação à cotação de origem, é preciso desfazer os dois efeitos: dividir pela razão para obter o valor por ação individual e converter as moedas para expressar ambos os preços na mesma unidade. Este endpoint faz exatamente essa aritmética em uma única chamada, sem surpresas de arredondamento, para que um screener, um monitor de arbitragem ou uma simples planilha possam colocar os dois mercados lado a lado e comparar o que é comparável.

A fórmula e o significado de cada entrada

A conversão é uma única linha: o preço da ação é igual ao preço do certificado multiplicado pela taxa de câmbio e dividido pela razão. <code>adr_price</code> é o último preço negociado de um certificado na sua moeda de listagem. <code>ratio</code> indica quantas ações ordinárias um certificado representa: uma razão de 0.5 significa dois certificados por ação, e uma razão de 5 significa que um certificado reúne cinco ações. <code>exchange_rate</code> é expresso como moeda do certificado por unidade da moeda local: se o certificado é negociado em dólares e as ações em libras, é o número de dólares por libra. A taxa de câmbio deve ser positiva, porque uma taxa zero ou negativa nunca é uma cotação real e quase sempre indica um erro de dados a montante; o endpoint a rejeita em vez de devolver um zero enganoso. O resultado é arredondado por padrão para seis casas decimais, e você pode pedir de zero a doze.

Como usar o resultado sem se enganar

A saída é o preço teórico equivalente de uma ação ordinária na sua moeda local, dados os valores que você forneceu. Se o certificado de fato é negociado com prêmio ou desconto é outra questão: compare o valor devolvido com a cotação ao vivo do mercado de origem e lembre-se de que os dois mercados podem não estar abertos ao mesmo tempo, de modo que os preços comparados podem vir de momentos diferentes. Taxas, tratamento de dividendos e impostos locais fazem, além disso, com que a paridade teórica raramente seja atingida ao centavo. Nada disso é função desta ferramenta: ela faz deliberadamente um único cálculo determinístico e o faz com exatidão, igual no seu navegador e na API paga, para que você possa prototipar a comparação manualmente e automatizá-la, por US$ 0,002 por requisição, apenas quando os números fizerem sentido. Tudo roda na nossa edge global e nada do que você enviar é armazenado depois que a resposta é devolvida.

Compare o certificado com a cotação de origem

Converta a cotação do ADR para o preço da ação na moeda local e veja de relance se o certificado é negociado com prêmio ou desconto.

Alimente um monitor de arbitragem

Calcule os preços de paridade em lote sobre a sua lista de acompanhamento e sinalize os pares cuja diferença ultrapasse o seu limite.

Explique a razão a um cliente

Mostre por que um certificado de 25 dólares corresponde a uma ação com preço muito maior ou menor depois de aplicadas a razão e a moeda.

Quanto custa?

US$ 0,002 por requisição via API. Também é grátis executar no seu navegador nesta página.

O que é exatamente a razão?

O número de ações ordinárias que um certificado de depósito representa. Uma razão de 0.5 significa dois certificados por ação; uma razão de 5 significa que um certificado reúne cinco ações.

Como a taxa de câmbio é expressa?

Como moeda do certificado por unidade da moeda local da ação. Se o certificado é negociado em USD e as ações em GBP, é o valor em dólares por libra.

Por que a minha entrada foi rejeitada?

A taxa de câmbio e a razão devem ser positivas, e o preço do certificado não pode ser negativo. Uma taxa zero ou negativa nunca é uma cotação real, então o endpoint a trata como erro de dados.

Ele devolve o valor justo do certificado?

Não. Ele devolve o preço equivalente da ação ordinária para o preço de certificado que você informou. Se isso implica prêmio ou desconto, cabe a você julgar diante da cotação ao vivo do mercado de origem.

Quantas casas decimais tem o resultado?

Seis por padrão, ajustáveis de zero a doze com o campo decimals.

Tudo nesta página está disponível via API. Esta seção é para equipes que querem integrar a ferramenta aos próprios sistemas; quem não precisa disso pode simplesmente usar a ferramenta acima.

POSThttps://api.kit.forhosting.com/fin/adr

Autenticação por token Bearer. Um único POST coloca a tarefa na fila; o resultado chega por webhook ou link assinado.

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}'
{
  "adr_price": 25.5,
  "ratio": 0.5,
  "exchange_rate": 1.27
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "fin.adr",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

A API é assíncrona: cada chamada devolve um task_id na hora. Se preferir polling, consulte o status a até 1 requisição por segundo.

por chamadaUS$ 0,002

Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.

HTTPCódigoO que significa
401unauthorizedToken ausente ou inválido. Confira o header Authorization.
402insufficient_balanceSaldo insuficiente para esta tarefa. Faça uma recarga e tente de novo.
404unknown_typeEsse tipo de tarefa não existe. Confira o campo type no catálogo.
429rate_limitedMuitas requisições em pouco tempo. Espere um instante e tente de novo.

Ver a documentação completa do KIT →