ForHosting KIT · Strumenti per sviluppatori

Cifra di controllo CUSIP

Inserisca i primi otto caratteri di un CUSIP e ottenga il nono: 03783310 riceve la cifra di controllo 0 e diventa 037833100. Se ha già il codice completo di nove caratteri, verifichi l'ultima cifra prima di registrare un'operazione. Gratis nel suo browser.

  • Gratis
  • Funziona nel suo browser
  • Senza registrazione
  • I suoi dati restano sul dispositivo
Usalo da WebAPIEmailTelegramApp presto
Se inserisce
Numero CUSIP
03783310
Ottiene
Modalità di calcolo
Compute
Input
03783310
Cifra di controllo
0
Numero CUSIP
037833100

Gli identificatori CUSIP etichettano azioni, obbligazioni e altri titoli nordamericani affinché sistemi di clearing, ticket d’ordine e file di portafoglio concordino sullo stesso codice di nove caratteri. I primi otto identificano emittente ed emissione; il nono è una cifra di controllo calcolata dal corpo, così che un errore di digitazione o una trasposizione fallisca spesso prima che un’operazione sia registrata sullo strumento sbagliato. Questa capacità implementa quell’algoritmo standard: mappa cifre e lettere in valori, raddoppia le posizioni alternate, somma le cifre decimali e restituisce la cifra che rende il totale multiplo di dieci. Usi la modalità compute quando dispone solo del corpo di otto caratteri e le serve la cifra finale, o la modalità validate quando riceve un CUSIP completo di nove e le serve un booleano più la cifra attesa per i messaggi di errore.

Come si calcola la cifra di controllo CUSIP

Un CUSIP ha nove caratteri secondo il layout familiare in stile ANSI X9.6: sei per l’emittente, due per l’emissione e una cifra di controllo finale. Ogni carattere del corpo è mappato a un numero: le cifre da zero a nove restano tali, le lettere da A a Z diventano da dieci a trentacinque, e i simboli speciali asterisco, chiocciola e cancelletto valgono trentasei, trentasette e trentotto quando compaiono. Percorrendo gli otto caratteri del corpo da sinistra a destra, i valori nelle posizioni seconda, quarta, sesta e ottava vengono raddoppiati.

Ogni numero risultante è ridotto sommando le sue cifre decimali — ad esempio quattordici diventa cinque — così che i grandi valori delle lettere non dominino il totale. Quelle somme di cifre vengono addizionate. La cifra di controllo è dieci meno il totale modulo dieci, e quel risultato di nuovo modulo dieci, il che produce una sola cifra da zero a nove.

Aggiungendo quella cifra si ottiene un CUSIP completo di nove caratteri la cui somma ponderata di cifre è congruente a zero modulo dieci. Rispetto alle cifre di controllo dei codici a barre al dettaglio come EAN-13 o al Luhn delle carte di pagamento, il CUSIP è alfanumerico e a lunghezza fissa, ed è per questo che rientra tra le utilità di codifica degli identificatori di titoli piuttosto che tra i validatori di codici prodotto.

Modalità compute rispetto a modalità validate

Invii un campo cusip che contenga solo caratteri ammessi dopo l’eventuale rimozione di spazi e trattini. La modalità validate attende esattamente nove caratteri, con il nono una cifra da zero a nove. Stringhe vuote, cusip mancante, lunghezza errata per la modalità scelta, nono carattere non numerico in validate e valori di mode non validi falliscono prima di qualsiasi somma ponderata e non vengono fatturati.

Le lettere sono accettate senza distinzione di maiuscole e normalizzate in maiuscolo nell’input ecoato, così che i batch possano incollare testo misto da fogli di calcolo. Preferisca compute quando completa un corpo da un fornitore di dati che omette la cifra di controllo; preferisca validate quando un utente, un file partner o uno scanner invia un CUSIP completo e le serve un gate booleano prima di cercare lo strumento.

Dove le cifre di controllo CUSIP si inseriscono nei flussi reali

Broker-dealer e team operativi del lato buy-side importano file di posizioni e negoziazioni di fine giornata in cui un solo carattere trasposto può contabilizzare rischio sul bond o sull’azione sbagliati. Convalidare ogni CUSIP all’import e mettere in quarantena le righe con valid false previene l’inquinamento silenzioso del master data. I desk di transfer agent e di corporate actions ricalcolano le cifre di controllo quando assemblano codici emittente ed emissione da feed separati, usando la modalità compute affinché il codice di nove caratteri memorizzato rispetti la convenzione di settore.

I test di integrazione e i job di qualità dei dati ricalcolano la cifra di controllo attesa per ogni riga di un export CSV e segnalano le righe il cui CUSIP completo memorizzato non coincide più, individuando sia modifiche umane sia bug di uno nei generatori. Non consideri un controllo CUSIP superato come prova che il titolo esista, sia liquido o sia autorizzato alla negoziazione: dimostra solo che la stringa di nove caratteri è ben formata secondo questo algoritmo, lo stesso criterio di onestà che applica a qualsiasi checksum.

Completare un corpo CUSIP di otto caratteri

Quando un feed o un foglio di calcolo fornisce solo il corpo di otto caratteri di emittente più emissione, chiami la modalità compute e memorizzi il cusip completo restituito affinché ogni sistema a valle riceva un identificatore standard di nove caratteri.

Auditare le esportazioni del master titoli

Convalidi in batch ogni colonna CUSIP di un export di portafoglio, custodia o corporate actions e metta in quarantena le righe la cui cifra di controllo finale non coincide più con il valore atteso ricalcolato.

Che cos’è una cifra di controllo CUSIP?

È il nono carattere di un CUSIP, una cifra singola 0–9 calcolata dal corpo di otto caratteri affinché gli errori di digitazione comuni falliscano spesso su un checksum modulare prima di usare il titolo sbagliato.

Quali caratteri sono ammessi?

Cifre 0–9, lettere A–Z (senza distinzione di maiuscole) e, facoltativamente, * @ #. Spazi e trattini vengono rimossi.

Lo strumento di cifra di controllo CUSIP è gratuito?

Lo strumento del browser è gratuito e viene eseguito in locale.

Come si calcola la cifra di controllo CUSIP?

Ciascuno degli otto caratteri diventa un numero: le cifre restano uguali e le lettere dalla A alla Z valgono da dieci in su. I valori nelle posizioni pari vengono raddoppiati, si sommano le cifre di ogni risultato e la cifra di controllo è ciò che manca per arrivare a un multiplo di dieci.

Un CUSIP valido dimostra che il titolo esiste?

No. Una cifra di controllo corretta dimostra solo che i nove caratteri sono ben formati secondo la regola CUSIP. Lo strumento non consulta alcun archivio, quindi non conferma che il titolo esista, sia quotato o sia autorizzato.

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.

POSThttps://api.kit.forhosting.com/enc/cusip

Autenticazione con Bearer token: un POST mette in coda l'attività e il risultato arriva via webhook o link firmato.

curl -X POST https://api.kit.forhosting.com/enc/cusip \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"cusip":"03783310"}'
{
  "cusip": "03783310"
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "enc.cusip",
  "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.

per richiesta$0.002

Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.

HTTPCodiceSignificato
401unauthorizedChiave API mancante o non valida: controlla l'header Authorization.
402insufficient_balanceCredito esaurito: ricarica per continuare a eseguire attività.
404unknown_typeTipo di attività sconosciuto: controlla il campo type della richiesta.
429rate_limitedTroppe richieste in poco tempo: rallenta e riprova tra qualche secondo.

Caratteri non CUSIP e lunghezze errate falliscono con un errore invalid_input chiaro invece di una corruzione silenziosa. La esegua gratis nel browser o chiami l’API KIT al prezzo pubblicato; entrambi i percorsi usano la stessa aritmetica pura, senza consultazione di rete a un master di titoli.

Come si calcola la cifra di controllo CUSIP

Questo strumento applica esattamente quel percorso standard; non inventa una variante interna e nomina sempre l’algoritmo come cusip nel JSON affinché i log a valle possano registrare quale schema ha protetto il campo.

Modalità compute rispetto a modalità validate

La modalità compute è predefinita e richiede esattamente otto caratteri: il motore mappa e pesa il corpo, restituisce check_digit come stringa di un carattere e restituisce cusip come l’identificatore completo di nove caratteri così che Lei possa archiviarlo o stamparlo in un’unica stringa. La risposta riporta valid true quando la cifra finale memorizzata coincide con l’expected_check_digit ricalcolato, e include sempre body senza l’ultimo carattere affinché le interfacce evidenzino ciò che è stato digitato rispetto a ciò che l’algoritmo si aspetta. Poiché il percorso è parse puro, senza orologio, fonte casuale né rete, lo stesso input produce sempre lo stesso JSON sullo strumento gratuito del browser e sull’API. A $0.002 per richiesta riuscita può proteggere importazioni massive di master titoli, moduli di onboarding e schermate di inserimento ordini senza negoziare un livello personalizzato.

Dove le cifre di controllo CUSIP si inseriscono nei flussi reali

I sistemi di portafoglio e performance che accettano l’inserimento manuale di titoli possono mostrare expected_check_digit accanto a un campo fallito così che lo staff corregga un errore di digitazione invece di aprire un ticket di ricerca. I team di prodotto che costruiscono ticket d’ordine o watchlist possono subordinare l’invio alla modalità validate prima di chiamare un’API di market data o di trading che altrimenti rifiuterebbe il simbolo con un errore meno chiaro. In ogni flusso il contratto è lo stesso: solo caratteri ammessi, compute o validate, JSON strutturato verificabile con goldens, comportamento identico gratis nel browser o tramite saldo prepagato KIT, e fallimento onesto quando l’input non è un corpo CUSIP o un codice completo ben formati.

Convalidare CUSIP digitati o importati all’ingresso

Quando un utente o un file partner invia un CUSIP completo di nove caratteri, chiami la modalità validate e blocchi la ricerca se valid è false, mostrando expected_check_digit per aiutare a correggere un solo errore di digitazione.

Come calcolo una cifra di controllo CUSIP con questa API?

Invii un POST con cusip uguale al corpo di otto caratteri e mode compute (oppure ometta mode). La risposta include check_digit e cusip (corpo più cifra di controllo).

Come convalidare un CUSIP completo di nove caratteri?

Invii un POST con la stringa completa di nove caratteri e mode validate. La risposta include valid, check_digit, expected_check_digit e body senza l’ultima cifra.

Leggi la documentazione completa del KIT →