Convertitore di prezzo ADR in azione ordinaria
Un certificato di deposito raggruppa un numero fisso di azioni ordinarie estere, quindi il suo prezzo non coincide mai con quello dell'azione sul mercato di origine: tra i due si frappongono il rapporto di conversione e il tasso di cambio.
Esegui gratis nel browser
Questa API prende il prezzo del certificato, il rapporto e il tasso di cambio e restituisce il prezzo equivalente di un'azione ordinaria nella sua valuta locale: la cifra che Le serve per confrontare il certificato con la quotazione di origine e individuare un premio o uno sconto.
Perché il prezzo del certificato non è mai quello dell'azione
Quando una società estera si quota negli Stati Uniti, una banca depositaria crea certificati che rappresentano ciascuno un numero determinato di azioni ordinarie: a volte una frazione di azione, a volte dieci o cinquanta. Oltre a questo raggruppamento, il certificato viene scambiato in dollari mentre le azioni ordinarie sono scambiate in sterline, yen o euro. Due investitori che osservano la stessa società vedono quindi due cifre completamente diverse sui loro schermi, e nessuna delle due è sbagliata. Per capire se l'ADR è caro o conveniente rispetto alla quotazione di origine bisogna annullare entrambi gli effetti: dividere per il rapporto per ottenere il valore per singola azione e convertire le valute per esprimere i due prezzi nella stessa unità. Questo endpoint esegue esattamente questa aritmetica in una sola chiamata, senza sorprese di arrotondamento, così uno screener, un monitor di arbitraggio o un semplice foglio di calcolo possono affiancare i due mercati e confrontare ciò che è confrontabile.
La formula e il significato di ogni input
La conversione è una sola riga: il prezzo dell'azione è uguale al prezzo del certificato moltiplicato per il tasso di cambio e diviso per il rapporto. <code>adr_price</code> è l'ultimo prezzo negoziato di un certificato nella sua valuta di quotazione. <code>ratio</code> indica quante azioni ordinarie un certificato rappresenta: un rapporto di 0.5 significa due certificati per azione, mentre un rapporto di 5 significa che un certificato raggruppa cinque azioni. <code>exchange_rate</code> è espresso come valuta del certificato per unità della valuta locale: se il certificato è scambiato in dollari e le azioni in sterline, è il numero di dollari per sterlina. Il tasso di cambio deve essere positivo, perché un tasso zero o negativo non è mai una quotazione reale e segnala quasi sempre un errore nei dati a monte; l'endpoint lo rifiuta invece di restituire uno zero fuorviante. Il risultato è arrotondato per impostazione predefinita a sei decimali, e Lei può richiederne da zero a dodici.
Usare il risultato senza illudersi
L'output è il prezzo teorico equivalente di un'azione ordinaria nella sua valuta locale, dati i valori che Lei ha fornito. Se il certificato è effettivamente scambiato con premio o sconto è un'altra questione: confronti il valore restituito con la quotazione in tempo reale del mercato di origine e ricordi che i due mercati potrebbero non essere aperti contemporaneamente, quindi i prezzi confrontati possono riferirsi a momenti diversi. Commissioni, trattamento dei dividendi e imposte locali fanno inoltre sì che la parità teorica venga raramente raggiunta al centesimo. Niente di tutto questo è compito di questo strumento: esegue deliberatamente un unico calcolo deterministico e lo esegue con esattezza, identico nel Suo browser e attraverso l'API a pagamento, così Lei può prototipare il confronto a mano e automatizzarlo, a $0.002 a richiesta, solo quando i numeri hanno senso. Tutto viene eseguito sul nostro edge globale e nulla di ciò che invia viene conservato dopo la restituzione della risposta.
Casi d'uso
Confronti il certificato con la quotazione di origine
Converta la quotazione dell'ADR nel prezzo dell'azione in valuta locale e veda a colpo d'occhio se il certificato è scambiato con premio o sconto.
Alimenti un monitor di arbitraggio
Calcoli i prezzi di parità in blocco sulla Sua lista di osservazione e segnali le coppie il cui scostamento supera la Sua soglia.
Spieghi il rapporto a un cliente
Mostri perché un certificato da 25 dollari corrisponde a un'azione dal prezzo molto superiore o inferiore una volta applicati rapporto e valuta.
Domande frequenti
Quanto costa?
$0.002 a richiesta tramite l'API. È anche gratis eseguirlo nel Suo browser su questa pagina.
Che cos'è esattamente il rapporto?
Il numero di azioni ordinarie che un certificato di deposito rappresenta. Un rapporto di 0.5 significa due certificati per azione; un rapporto di 5 significa che un certificato raggruppa cinque azioni.
Come è espresso il tasso di cambio?
Come valuta del certificato per unità della valuta locale dell'azione. Se il certificato è scambiato in USD e le azioni in GBP, sono i dollari per sterlina.
Perché il mio input è stato rifiutato?
Il tasso di cambio e il rapporto devono essere positivi, e il prezzo del certificato non può essere negativo. Un tasso zero o negativo non è mai una quotazione reale, quindi l'endpoint lo tratta come un errore dei dati.
Restituisce il fair value del certificato?
No. Restituisce il prezzo equivalente dell'azione ordinaria per il prezzo di certificato che Lei ha indicato. Se ciò implica un premio o uno sconto spetta a Lei giudicarlo rispetto alla quotazione in tempo reale del mercato di origine.
Quanti decimali ha il risultato?
Sei per impostazione predefinita, regolabili da zero a dodici con il campo decimals.
Per sviluppatori — accesso via API
Tutto quello che vedi in questa pagina è disponibile anche via API. Questa sezione è per i team che vogliono integrarlo nei propri sistemi; chi non ne ha bisogno può semplicemente usare lo strumento qui sopra.
Endpoint
Autenticazione con Bearer token: un POST mette in coda l'attività e il risultato arriva via webhook o link firmato.
Chiamala dal tuo 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)Esempio di richiesta
{
"adr_price": 25.5,
"ratio": 0.5,
"exchange_rate": 1.27
}Esempio di risposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "fin.adr",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}L'API è asincrona: ricevi subito un task_id e puoi fare polling fino a 1 richiesta al secondo.
Prezzi
Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.
Errori
| HTTP | Codice | Significato |
|---|---|---|
401 | unauthorized | Chiave API mancante o non valida: controlla l'header Authorization. |
402 | insufficient_balance | Credito esaurito: ricarica per continuare a eseguire attività. |
404 | unknown_type | Tipo di attività sconosciuto: controlla il campo type della richiesta. |
429 | rate_limited | Troppe richieste in poco tempo: rallenta e riprova tra qualche secondo. |