README.md

Ticker symbol parsing and convention conversions.

Install

pip install symbol_parser

All functionality is accessed through the Symbol class.

from symbol_parser import Symbol

see symbol.py for usage.

Data

Data used in this module is extracted from https://www.nasdaqtrader.com/Trader.aspx?id=CQSSymbolConvention

Security Categorization	CQS Suffix	CMS Suffix	NASDAQ Integrated Platform Suffix	NASDAQ ACT/CTCI Suffixes
Preferred	p	PR	-	$
Preferred Class "A"*	pA	PRA	-A	$A
Preferred Class "B"*	pB	PRB	-B	$B
Class "A"*	.A	A	.A	.A
Class "B"*	.B	B	.B	.B
Preferred when distributed	p.WD	PRWD	-$	.D
When distributed	.WD	WD	$	.Z
Warrants	.WS	WS	+	.W
Warrants Class "A"*	.WS.A	WSA	+A	.W or .A**
Warrants Class "B"*	.WS.B	WSB	+B
Called	.CL	CL	*
Class "A" Called*	.A.CL	ACL	.A*	.A
Preferred called	p.CL	PRCL	-*	$
Preferred "A" called*	pA.CL	PRACL	-A*	$A
Preferred "A" when issued*	pAw	PRAWI	-A#	.V or .Z
Emerging Company Marketplace	.EC	EC	!	.E
Partial Paid	.PP	PP	@
Convertible	.CV	CV	%
Convertible called	.CV.CL	CVCL	%*
Class Convertible	.A.CV	ACV	.A%
Preferred (class A) Convertible	pA.CV	PRACV	-A%
Preferred (class A) when Distributed	pA.WD	PRAWD	-A$
Rights	r	RT	^	.R
Units	.U	U	=	.U
When issued	w	WI	#	.V or .Z
Rights when issued	rw	RTWI	^#	.V or .Z
Preferred when issued	pw	PRWI	-#	.V or .Z
Class "A" when issued*	.Aw	AWI	.A#	.V or .Z
Warrrant when issued	.WSw	WSWI	+#	.V or .Z
TEST symbol	.TEST	TEST	~