Brokerage Web Options Expiry Countdown

WHAT IT DOES This userscript helps options traders track expiration dates by displaying real-time countdown timers on brokerage options pages. It scans brokerage options trading pages, positions lists, or order entry screens for option contracts with expiration dates, then calculates the time remaining until each contract expires. It displays a visual panel showing each contract's symbol, type, strike price, and the time remaining in days, hours, and minutes. The script color-codes options by urgency: red for 90 days. It can group contracts by expiration date, show total contracts per expiry, and highlight approaching expirations with notifications. WHERE IT RUNS The script works on brokerage options trading pages, positions lists, and order entry screens—common on platforms like Fidelity, Vanguard, Schwab, E*TRADE, TD Ameritrade, and similar brokerages. It runs entirely within your browser, reading only the visible content of the current page. It does not track your browsing history, access other tabs, or send any data externally. All calculations are performed locally. HOW TO USE After installation, open the panel by clicking the tool's icon in the BotGentz sidebar. The script auto-scans options pages on load (toggle this on/off). Toggle "Group by expiration date" to organize contracts by their expiry date. Click "Scan options" to manually analyze the page. The panel displays all detected option contracts with their expiration date, symbol, type, strike price, quantity, and a live countdown timer showing time remaining. Urgency colors help you quickly identify which options are expiring soon. The panel also shows a summary of total contracts and any expired contracts. Use "Clear countdown" to remove the display. THE TECHNICAL MECHANISM This script uses DOM traversal and pattern matching to extract option contract data from brokerage pages. It scans for option-related elements using selectors like .option, .contract, .position, [class*="option"], and [class*="contract"]. For each element, it extracts expiration dates using regex patterns for MM/DD/YYYY, YYYY-MM-DD, and named month formats. It also extracts the symbol (stock ticker), strike price using currency patterns, quantity using "X contracts" patterns, and determines whether the option is a CALL or PUT based on text content. The script calculates the time remaining from the current time to the expiration date, then displays it in days, hours, and minutes. Options are categorized by days remaining using five categories with corresponding colors. The refresh interval updates the display every 60 seconds to keep timers current. THE PANEL The panel is draggable anywhere on the screen and remembers its position between sessions. It can be collapsed to a small floating bubble to minimize distraction, and expanded again with a single click. The panel's width can be adjusted, and pressing the Escape key closes it instantly. All settings—group by expiration and auto-scan—are persisted locally using GM_setValue, so your preferences remain intact across page reloads and browser restarts. PLEASE NOTE This userscript requires the free BotGentz extension to function. The script is designed for brokerage options pages; it may work on other financial sites but is not guaranteed. The extraction relies on the current text patterns on each site—if a site updates its UI or wording, the script may need to be updated. Countdown timers are approximate and updated every 60 seconds; they do not account for weekends or market holidays. The script does not access your account or API; it only reads what is visible on the page. No data from your browsing is stored or transmitted anywhere—all processing occurs entirely in your browser.