@credentum/is-cusip

Zero-dependency CUSIP validator for JavaScript and TypeScript.

Validates 9-character CUSIP identifiers used to identify North American financial securities. Uses the Modulus 10 Double Add Double check digit algorithm.

Install

npm install @credentum/is-cusip

Usage

const isCUSIP = require('@credentum/is-cusip');

isCUSIP('037833100'); // true  — Apple Inc.
isCUSIP('17275R102'); // true  — Cisco Systems
isCUSIP('68389X106'); // false — bad check digit

ESM

import isCUSIP from '@credentum/is-cusip';
// or
import { isCUSIP, sanitizeCUSIP } from '@credentum/is-cusip';

Sanitize before validating

const { isCUSIP, sanitizeCUSIP } = require('@credentum/is-cusip');

const raw = ' 037-833-100 ';
isCUSIP(sanitizeCUSIP(raw)); // true

sanitizeCUSIP trims whitespace, removes dashes and spaces, and uppercases the input. It does not validate.

API

isCUSIP(input: string): boolean

Returns true if the input is a valid 9-character CUSIP with a correct check digit.

sanitizeCUSIP(input: string): string

Cleans raw input for validation. Trims, removes - and spaces, uppercases.

License

MIT