From 04abd15fcc9b51f4ae807850a50b46d145741e4d Mon Sep 17 00:00:00 2001 From: Anson Biggs Date: Fri, 13 Oct 2023 05:37:48 +0000 Subject: [PATCH] Resolve "Add Options from MarketData.app" --- README.md | 8 +-- common/MarketData.py | 57 +++++++++++++++++++++ common/Symbol.py | 3 +- common/requirements.txt | 11 ++-- common/symbol_router.py | 25 ++++++--- dev-reqs.txt | 3 +- discord/D_info.py | 6 +-- discord/bot.py | 78 ++++++++++++++++++++++++----- site/docs/blog/posts/intro.md | 4 +- site/docs/commands.md | 12 +++-- site/docs/img/telegram_options.png | Bin 0 -> 21475 bytes telegram/T_info.py | 6 +-- telegram/bot.py | 63 +++++++++++++++++++++-- tests.py | 14 +----- 14 files changed, 233 insertions(+), 57 deletions(-) create mode 100644 site/docs/img/telegram_options.png diff --git a/README.md b/README.md index 2ec5404..efc79eb 100644 --- a/README.md +++ b/README.md @@ -9,8 +9,8 @@ Enhance your group chats on Telegram and Discord with real-time stock and crypto ## Documentation Comprehensive documentation is available to help you understand the features and capabilities of Simple Stock Bots: -- [Official Documentation](https://docs.simplestockbot.com/) -- [Command Reference](https://docs.simplestockbot.com/commands/) +- [Official Documentation](https://simplestockbot.com/) +- [Command Reference](https://simplestockbot.com/commands/) ## Support the Project @@ -32,12 +32,12 @@ You can contribute by: ## Hosting Self-hosting instructions are provided for those interested in running the bot on their own servers: -- [Hosting Guide](https://docs.simplestockbot.com/hosting/) +- [Hosting Guide](https://simplestockbot.com/hosting/) ## Contact Reach out for bug reports, feature requests, or other inquiries: -- [Contact Page](https://docs.simplestockbot.com/contact/) +- [Contact Page](https://simplestockbot.com/contact/) --- diff --git a/common/MarketData.py b/common/MarketData.py index 4c48201..eeb6837 100644 --- a/common/MarketData.py +++ b/common/MarketData.py @@ -2,7 +2,9 @@ import datetime as dt import logging import os from typing import Dict +from collections import OrderedDict +import humanize import pandas as pd import pytz import requests as r @@ -286,3 +288,58 @@ class MarketData: return df return pd.DataFrame() + + def options_reply(self, request: str) -> str: + """Undocumented API Usage!""" + + options_data = self.get(f"options/quotes/{request}") + + for key in options_data.keys(): + options_data[key] = options_data[key][0] + + options_data["underlying"] = "$" + options_data["underlying"] + + options_data["updated"] = humanize.naturaltime(dt.datetime.now() - dt.datetime.fromtimestamp(options_data["updated"])) + + options_data["expiration"] = humanize.naturaltime( + dt.datetime.now() - dt.datetime.fromtimestamp(options_data["expiration"]) + ) + + options_data["firstTraded"] = humanize.naturaltime( + dt.datetime.now() - dt.datetime.fromtimestamp(options_data["firstTraded"]) + ) + + rename = { + "optionSymbol": "Option Symbol", + "underlying": "Underlying", + "expiration": "Expiration", + "side": "side", + "strike": "strike", + "firstTraded": "First Traded", + "updated": "Last Updated", + "bid": "bid", + "bidSize": "bidSize", + "mid": "mid", + "ask": "ask", + "askSize": "askSize", + "last": "last", + "openInterest": "Open Interest", + "volume": "Volume", + "inTheMoney": "inTheMoney", + "intrinsicValue": "Intrinsic Value", + "extrinsicValue": "Extrinsic Value", + "underlyingPrice": "Underlying Price", + "iv": "Implied Volatility", + "delta": "delta", + "gamma": "gamma", + "theta": "theta", + "vega": "vega", + "rho": "rho", + } + + options_cleaned = OrderedDict() + for old, new in rename.items(): + if old in options_data: + options_cleaned[new] = options_data[old] + + return options_cleaned diff --git a/common/Symbol.py b/common/Symbol.py index d2c50b1..cdd8602 100644 --- a/common/Symbol.py +++ b/common/Symbol.py @@ -1,6 +1,7 @@ -import pandas as pd import logging +import pandas as pd + class Symbol: """ diff --git a/common/requirements.txt b/common/requirements.txt index 43b172f..540be38 100644 --- a/common/requirements.txt +++ b/common/requirements.txt @@ -1,6 +1,7 @@ -requests==2.31.0 -pandas==2.1.1 -schedule==1.2.1 -mplfinance==0.12.10b0 -markdownify==0.11.6 cachetools==5.3.1 +humanize==4.8.0 +markdownify==0.11.6 +mplfinance==0.12.10b0 +pandas==2.1.1 +requests==2.31.0 +schedule==1.2.1 diff --git a/common/symbol_router.py b/common/symbol_router.py index 2109dd4..e09a453 100644 --- a/common/symbol_router.py +++ b/common/symbol_router.py @@ -5,6 +5,7 @@ import datetime import logging import random import re +from typing import Dict import pandas as pd import schedule @@ -14,8 +15,6 @@ from common.cg_Crypto import cg_Crypto from common.MarketData import MarketData from common.Symbol import Coin, Stock, Symbol -from typing import Dict - log = logging.getLogger(__name__) @@ -38,7 +37,7 @@ class Router: t_copy = self.trending_count.copy() for key in t_copy.keys(): if t_copy[key] < 0.01: - # This just makes sure were not keeping around keys that havent been called in a very long time. + # Prune Keys dead_keys.append(key) else: t_copy[key] = t_copy[key] * decay @@ -48,7 +47,7 @@ class Router: self.trending_count = t_copy.copy() log.info("Decayed trending symbols.") - def find_symbols(self, text: str, *, trending_weight: int = 1) -> list[Stock | Symbol]: + def find_symbols(self, text: str, *, trending_weight: int = 1) -> list[Stock | Coin]: """Finds stock tickers starting with a dollar sign, and cryptocurrencies with two dollar signs in a blob of text and returns them in a list. @@ -66,6 +65,8 @@ class Router: symbols: list[Symbol] = [] stock_matches = set(re.findall(self.STOCK_REGEX, text)) + coin_matches = set(re.findall(self.CRYPTO_REGEX, text)) + for stock_match in stock_matches: # Market data lacks tools to check if a symbol is valid. if stock_info := self.stock.symbol_id(stock_match): @@ -73,11 +74,10 @@ class Router: else: log.info(f"{stock_match} is not in list of stocks") - coins = set(re.findall(self.CRYPTO_REGEX, text)) - for coin in coins: - sym = self.crypto.symbol_list[self.crypto.symbol_list["symbol"].str.fullmatch(coin.lower(), case=False)] + for coin_match in coin_matches: + sym = self.crypto.symbol_list[self.crypto.symbol_list["symbol"].str.fullmatch(coin_match.lower(), case=False)] if sym.empty: - log.info(f"{coin} is not in list of coins") + log.info(f"{coin_match} is not in list of coins") else: symbols.append(Coin(sym)) if symbols: @@ -396,3 +396,12 @@ class Router: replies = replies + self.crypto.batch_price(coins) return replies + + def options(self, request: str, symbols: list[Symbol]) -> Dict: + request = request.lower() + if len(symbols) == 1: + symbol = symbols[0] + request = request.replace(symbol.tag.lower(), symbol.symbol.lower()) + return self.stock.options_reply(request) + else: + return self.stock.options_reply(request) diff --git a/dev-reqs.txt b/dev-reqs.txt index 9dae235..77b12b9 100644 --- a/dev-reqs.txt +++ b/dev-reqs.txt @@ -8,4 +8,5 @@ pylama==8.4.1 mypy==1.5.1 types-cachetools==5.3.0.6 types-pytz==2023.3.1.1 -ruff==0.0.292 \ No newline at end of file +ruff==0.0.292 +isort==5.12.0 \ No newline at end of file diff --git a/discord/D_info.py b/discord/D_info.py index 5ceb0c6..7f4057c 100644 --- a/discord/D_info.py +++ b/discord/D_info.py @@ -21,7 +21,7 @@ For stock data or hosting your own bot, use my link. This helps keep the bot fre **Updates**: Join the bot's discord: https://t.me/simplestockbotnews. -**Documentation**: All details about the bot are at [docs](https://docs.simplestockbot.com). +**Documentation**: All details about the bot are at [docs](https://simplestockbot.com). The bot reads _"Symbols"_. Use `$` for stock tickers and `$$` for cryptocurrencies. For example: - `/chart $$eth` gives Ethereum's monthly chart. @@ -41,7 +41,7 @@ Type @SimpleStockBot `[search]` anywhere to find and get stock/crypto prices. No Data from: [marketdata.app](https://dashboard.marketdata.app/marketdata/aff/go/misterbiggs?keyword=discord). -Issues with the bot? Use `/status` or [contact us](https://docs.simplestockbot.com/contact). +Issues with the bot? Use `/status` or [contact us](https://simplestockbot.com/contact). """ donate_text = """ @@ -55,5 +55,5 @@ Every donation supports server costs and 2. Or, donate at [buymeacoffee](https://www.buymeacoffee.com/Anson). - It's quick, doesn't need an account, and accepts Paypal or Credit card. -Questions? Visit our [website](https://docs.simplestockbot.com). +Questions? Visit our [website](https://simplestockbot.com). """ diff --git a/discord/bot.py b/discord/bot.py index 0f13070..eeb9cab 100644 --- a/discord/bot.py +++ b/discord/bot.py @@ -5,9 +5,9 @@ import os import mplfinance as mpf import nextcord +from D_info import D_info from nextcord.ext import commands -from D_info import D_info from common.symbol_router import Router DISCORD_TOKEN = os.environ["DISCORD"] @@ -38,7 +38,7 @@ async def on_ready(): @bot.command() async def status(ctx: commands): """Debug command for diagnosing if the bot is experiencing any issues.""" - logging.warning(f"Status command ran by {ctx.message.author}") + logging.info(f"Status command ran by {ctx.message.author}") message = "" try: message = "Contact MisterBiggs#0465 if you need help.\n" @@ -183,20 +183,74 @@ async def trending(ctx: commands): @bot.event async def on_message(message): + # Ignore messages from the bot itself if message.author.id == bot.user.id: return - if message.content: - if message.content[0] == "/": - await bot.process_commands(message) - return - if "$" in message.content: - symbols = s.find_symbols(message.content) + content_lower = message.content.lower() - if symbols: - for reply in s.price_reply(symbols): - await message.channel.send(reply) - return + # Process commands starting with "/" + if message.content.startswith("/"): + await bot.process_commands(message) + return + + symbols = None + if "$" in message.content: + symbols = s.find_symbols(message.content) + + if "call" in content_lower or "put" in content_lower: + await handle_options(message, symbols) + return + + if symbols: + for reply in s.price_reply(symbols): + await message.channel.send(reply) + return + + +async def handle_options(message, symbols): + logging.info("Options detected") + try: + options_data = s.options(message.content.lower(), symbols) + + # Create the embed directly within the function + embed = nextcord.Embed(title=options_data["Option Symbol"], description=options_data["Underlying"], color=0x3498DB) + + # Key details + details = ( + f"Expiration: {options_data['Expiration']}\n" f"Side: {options_data['side']}\n" f"Strike: {options_data['strike']}" + ) + embed.add_field(name="Details", value=details, inline=False) + + # Pricing info + pricing_info = ( + f"Bid: {options_data['bid']} (Size: {options_data['bidSize']})\n" + f"Mid: {options_data['mid']}\n" + f"Ask: {options_data['ask']} (Size: {options_data['askSize']})\n" + f"Last: {options_data['last']}" + ) + embed.add_field(name="Pricing", value=pricing_info, inline=False) + + # Volume and open interest + volume_info = f"Open Interest: {options_data['Open Interest']}\n" f"Volume: {options_data['Volume']}" + embed.add_field(name="Activity", value=volume_info, inline=False) + + # Greeks + greeks_info = ( + f"IV: {options_data['Implied Volatility']}\n" + f"Delta: {options_data['delta']}\n" + f"Gamma: {options_data['gamma']}\n" + f"Theta: {options_data['theta']}\n" + f"Vega: {options_data['vega']}\n" + f"Rho: {options_data['rho']}" + ) + embed.add_field(name="Greeks", value=greeks_info, inline=False) + + # Send the created embed + await message.channel.send(embed=embed) + + except KeyError as ex: + logging.warning(f"KeyError processing options for message {message.content}: {ex}") bot.run(DISCORD_TOKEN) diff --git a/site/docs/blog/posts/intro.md b/site/docs/blog/posts/intro.md index 0d9ff01..d57b232 100644 --- a/site/docs/blog/posts/intro.md +++ b/site/docs/blog/posts/intro.md @@ -51,11 +51,11 @@ Here are some simple commands to get you started: Simple Stock Bot is a community-supported project, thriving on the contributions from its users. It's sustained entirely through donations to cover server costs and premium market data subscriptions, ensuring it remains free for everyone. -Feeling generous? You can support the project by [donating](https://docs.simplestockbot.com/donate/), following on [Twitter](https://twitter.com/AnsonBiggs), or contributing on [GitLab](https://gitlab.com/simple-stock-bot). +Feeling generous? You can support the project by [donating](https://simplestockbot.com/donate/), following on [Twitter](https://twitter.com/AnsonBiggs), or contributing on [GitLab](https://gitlab.com/simple-stock-bot). ## Dive Deeper -Craving more insights and features? Explore the [official documentation](https://docs.simplestockbot.com/) to uncover all the capabilities of Simple Stock Bot. +Craving more insights and features? Explore the [official documentation](https://simplestockbot.com/) to uncover all the capabilities of Simple Stock Bot. Get ready to elevate your financial discussions with Simple Stock Bot! Your group chats will never be the same again. diff --git a/site/docs/commands.md b/site/docs/commands.md index d207de0..a1d0eb8 100644 --- a/site/docs/commands.md +++ b/site/docs/commands.md @@ -5,13 +5,12 @@ Symbols are used in headings to denote what platforms and symbol types a command - Bot Commands :robot: - Cryptocurrency Support :material-currency-btc: - Stock Market Support :bank: -- OTC Support :dollar: ## Get the Bots [:fontawesome-brands-telegram: Telegram](https://t.me/SimpleStockBot){ .md-button } [:fontawesome-brands-discord: Discord](https://discordapp.com/api/oauth2/authorize?client_id=532045200823025666&permissions=36507338752&scope=bot){ .md-button } -## Symbol Detection :material-currency-btc: :bank: :dollar: +## Symbol Detection :material-currency-btc: :bank: The Simple Stock Bot looks at every message it can see and tries to detect stock and cryptocurrency symbols. Stock market tickers are denoted with a single `$` and cryptocurrency coins are denoted with a double `$$`. So getting the price of Tesla is as simple as `$tsla` and Bitcoin `$$btc`. These symbols can be in any part of a message and there can be multiple of them aswell. @@ -29,6 +28,13 @@ The Simple Stock Bot looks at every message it can see and tries to detect stock +## Options Detection :bank: + +This command allows you to query real-time data for stock options. By simply inputting the stock symbol, strike price, month, and specifying either a call or a put, you can get the latest options data right at your fingertips. For example, `AAPL $220 December call` will provide the current data for Apple's call option with a $220 strike price expiring in December. + + +![Image of the telegram bot providing options info.](img/telegram_options.png) + ## `/donate [Amount in USD]` :fontawesome-brands-telegram-plane: The donate command is used to send money to the bot to help keep it free. The premium stock market data and server rentals add up so any amount helps. See the [Donate](donate.md) page for more information. @@ -171,7 +177,7 @@ Bot Status: -## Inline Features :fontawesome-brands-telegram: :material-currency-btc: :bank: :dollar: +## Inline Features :fontawesome-brands-telegram: :material-currency-btc: :bank: You can type @SimpleStockBot `[search]` in any chat or direct message to search for the stock bots full list of stock symbols and return the price of the ticker. Then once you select the ticker diff --git a/site/docs/img/telegram_options.png b/site/docs/img/telegram_options.png new file mode 100644 index 0000000000000000000000000000000000000000..1f8099c938a9f61bb56c14619f6c6e6a114c0a18 GIT binary patch literal 21475 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 JWt~$(69CXwO_Trt literal 0 HcmV?d00001 diff --git a/telegram/T_info.py b/telegram/T_info.py index f92f922..e2ccbba 100644 --- a/telegram/T_info.py +++ b/telegram/T_info.py @@ -21,7 +21,7 @@ Want stock data or to host your own bot? Help keep this bot free by using my 📢 Stay updated on the bot's Telegram: https://t.me/simplestockbotnews. -**Guide**: All about using and setting up the bot is in the [docs](https://docs.simplestockbot.com). +**Guide**: All about using and setting up the bot is in the [docs](https://simplestockbot.com). The bot recognizes _"Symbols"_. `$` for stocks and `$$` for cryptos. Example: - `/chart $$eth` gets a month's Ethereum chart. @@ -43,7 +43,7 @@ Pick a ticker, and the bot shares the current price in chat. Note: Prices can la Data thanks to [marketdata.app](https://dashboard.marketdata.app/marketdata/aff/go/misterbiggs?keyword=telegram). -Bot issues? Use `/status` or [contact us](https://docs.simplestockbot.com/contact). +Bot issues? Use `/status` or [contact us](https://simplestockbot.com/contact). """ @@ -56,7 +56,7 @@ All funds help maintain servers, with data from 1. Use `/donate [amount in USD]`. E.g., `/donate 2` donates 2 USD. 2. Or, quickly donate at [buymeacoffee](https://www.buymeacoffee.com/Anson). No account needed, accepts Paypal & Credit card. -For questions, visit our [website](https://docs.simplestockbot.com). +For questions, visit our [website](https://simplestockbot.com). """ diff --git a/telegram/bot.py b/telegram/bot.py index eb1122e..2497550 100644 --- a/telegram/bot.py +++ b/telegram/bot.py @@ -178,17 +178,33 @@ async def symbol_detect(update: Update, context: ContextTypes.DEFAULT_TYPE): message = update.message.text chat_id = update.message.chat_id if "$" in message: - symbols = s.find_symbols(message) log.info("Looking for Symbols") + symbols = s.find_symbols(message) else: return except AttributeError as ex: log.info(ex) return - if symbols: - # Let user know bot is working + + # Detect Options + if ("call" in message.lower()) or ("put" in message.lower()): + log.info("Options detected") await context.bot.send_chat_action(chat_id=chat_id, action=telegram.constants.ChatAction.TYPING) + try: + options_data = s.options(message, symbols) + + await update.message.reply_text( + text=generate_options_reply(options_data), + parse_mode=telegram.constants.ParseMode.MARKDOWN, + ) + return + except KeyError as ex: + logging.warning(ex) + pass + + if symbols: log.info(f"Symbols found: {symbols}") + await context.bot.send_chat_action(chat_id=chat_id, action=telegram.constants.ChatAction.TYPING) for reply in s.price_reply(symbols): await update.message.reply_text( @@ -198,6 +214,47 @@ async def symbol_detect(update: Update, context: ContextTypes.DEFAULT_TYPE): ) +def generate_options_reply(options_data: dict): + # Header with Option Symbol and Underlying + message_text = f"*{options_data['Option Symbol']} ({options_data['Underlying']})*\n\n" + + # Key details + details = ( + f"*Expiration:* `{options_data['Expiration']}`\n" + f"*Side:* `{options_data['side']}`\n" + f"*Strike:* `{options_data['strike']}`\n" + f"*First Traded:* `{options_data['First Traded']}`\n" + f"*Last Updated:* `{options_data['Last Updated']}`\n\n" + ) + message_text += details + + # Pricing info + pricing_info = ( + f"*Bid:* `{options_data['bid']}` (Size: `{options_data['bidSize']}`)\n" + f"*Mid:* `{options_data['mid']}`\n" + f"*Ask:* `{options_data['ask']}` (Size: `{options_data['askSize']}`)\n" + f"*Last:* `{options_data['last']}`\n\n" + ) + message_text += pricing_info + + # Volume and open interest + volume_info = f"*Open Interest:* `{options_data['Open Interest']}`\n" f"*Volume:* `{options_data['Volume']}`\n\n" + message_text += volume_info + + # Greeks + greeks_info = ( + f"*IV:* `{options_data['Implied Volatility']}`\n" + f"*Delta:* `{options_data['delta']}`\n" + f"*Gamma:* `{options_data['gamma']}`\n" + f"*Theta:* `{options_data['theta']}`\n" + f"*Vega:* `{options_data['vega']}`\n" + f"*Rho:* `{options_data['rho']}`\n" + ) + message_text += greeks_info + + return message_text + + async def intra(update: Update, context: ContextTypes.DEFAULT_TYPE): """returns a chart of intraday data for a symbol""" log.info(f"Intra command ran by {update.message.chat.username}") diff --git a/tests.py b/tests.py index 75b1d7b..996bcff 100644 --- a/tests.py +++ b/tests.py @@ -1,19 +1,9 @@ -import keyboard import time +import keyboard tests = """$$xno -/info $tsla -/info $$btc -/news $tsla -/news $$btc -/stat $tsla -/stat $$btc -/cap $tsla -/cap $$btc -/dividend $tsla -/dividend $msft -/dividend $$btc +$tsla /intra $tsla /intra $$btc /chart $tsla