1
0
mirror of https://gitlab.com/simple-stock-bots/simple-telegram-stock-bot.git synced 2025-06-16 06:56:46 +00:00
This commit is contained in:
Anson 2023-10-09 22:01:52 -06:00
parent f772083521
commit 40db63066b
12 changed files with 484 additions and 484 deletions

View File

@ -1,23 +1,23 @@
image: python:3.11
build_site:
stage: build
script:
- cd ./site
- pip install -r requirements.txt
- mkdocs build --site-dir ../public --verbose
artifacts:
paths:
- public
deploy_site:
stage: deploy
script:
- echo "Publishing site..."
dependencies:
- build_site
artifacts:
paths:
- public
rules:
- if: '$CI_COMMIT_BRANCH == $CI_DEFAULT_BRANCH'
image: python:3.11
build_site:
stage: build
script:
- cd ./site
- pip install -r requirements.txt
- mkdocs build --site-dir ../public --verbose
artifacts:
paths:
- public
deploy_site:
stage: deploy
script:
- echo "Publishing site..."
dependencies:
- build_site
artifacts:
paths:
- public
rules:
- if: '$CI_COMMIT_BRANCH == $CI_DEFAULT_BRANCH'

View File

@ -1,12 +1,12 @@
{
"yaml.schemas": {
"https://squidfunk.github.io/mkdocs-material/schema.json": "mkdocs.yml"
},
"yaml.customTags": [
"!ENV scalar",
"!ENV sequence",
"tag:yaml.org,2002:python/name:materialx.emoji.to_svg",
"tag:yaml.org,2002:python/name:materialx.emoji.twemoji",
"tag:yaml.org,2002:python/name:pymdownx.superfences.fence_code_format"
]
{
"yaml.schemas": {
"https://squidfunk.github.io/mkdocs-material/schema.json": "mkdocs.yml"
},
"yaml.customTags": [
"!ENV scalar",
"!ENV sequence",
"tag:yaml.org,2002:python/name:materialx.emoji.to_svg",
"tag:yaml.org,2002:python/name:materialx.emoji.twemoji",
"tag:yaml.org,2002:python/name:pymdownx.superfences.fence_code_format"
]
}

View File

@ -1,21 +1,21 @@
MIT License
Copyright (c) 2019 Anson Biggs
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
MIT License
Copyright (c) 2019 Anson Biggs
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

View File

@ -1,23 +1,23 @@
```
MIT License
Copyright (c) 2019 Anson Biggs
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
```
```
MIT License
Copyright (c) 2019 Anson Biggs
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
```

View File

@ -1,176 +1,176 @@
Symbols are used in headings to denote what platforms and symbol types a command supports.
- Telegram Only :fontawesome-brands-telegram-plane:
- Discord Only :fontawesome-brands-discord:
- Bot Commands :robot:
- Cryptocurrency Support :material-currency-btc:
- Stock Market Support :bank:
- OTC Support :dollar:
## Symbol Detection :material-currency-btc: :bank: :dollar:
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.
<div class="phone">
<div class="messages-wrapper">
<div class="message to">
I wonder how $tsla is affecting the price of $$btc
</div>
<div class="message from">
The current stock price of Tesla Inc is $866.57, the stock is currently up 1.68%
</div>
<div class="message from">
The current price of Bitcoin is $34,815, the coin is currently down -0.151% for today
</div>
</div>
</div>
## `/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.
<div class="phone">
<div class="messages-wrapper">
<div class="message to">
/donate
</div>
<div class="message from">
The current stock price of Tesla Inc is $664.315, the stock is
currently down -0.99%
</div>
</div>
</div>
## `/intra [symbol]` :bank: :material-currency-btc:
This command makes a chart of a stocks movement since the last market open, or the last 24 hours for cryptocurrency.
<div class="phone">
<div class="messages-wrapper">
<div class="message to">
/intra $astr
</div>
<div class="message from">
<img src="/img/TgIntraChat.jpg" alt="Tesla Motors Chart" />
<p>Intraday chart for $ASTR from 06 Jul at 09:30 to 06 Jul at 15:59</p>
<p>The current stock price of Astra Space Inc - Class A is $12.47, the stock is currently down -19.39%</p>
</div>
</div>
</div>
## `/chart [symbol]` :bank: :material-currency-btc:
This command makes a chart of the last 1 month of trading data up until the day before. For example running it on May 5th creates a chart from April 5th to May 4th.
<div class="phone">
<div class="messages-wrapper">
<div class="message to">
/intra $astr
</div>
<div class="message from">
<img src="/img/TgChartChat.jpg" alt="Tesla Motors Chart" />
<p>1 Month chart for Ethereum from 07, Jun 2021 to 07, Jul 2021</p>
<p>The current price of Ethereum is $2,389.62, the coin is currently up 2.485% for today</p>
</div>
</div>
</div>
## `/trending`
Gets the latest trending stocks and their change in price
<div class="phone">
<div class="messages-wrapper">
<div class="message to">
/trending
</div>
<pre class="message from">
🦍Trending on the Stock Bot:
━━━━━━━━━━━━━━━━━━━━━━━━━━
$GME: Gamestop Corporation - Class A, 5.06%
$MMAT: Meta Materials Inc, 4.77%
$$BTC: Bitcoin, -0.83%
$$ETH: Ethereum, 6.06%
$$DOGE: Binance-Peg Dogecoin, 0.14%
💵Trending Stocks:
━━━━━━━━━━━━━━━━
$BBIG: Vinco Ventures Inc, 15.44%
$GSAT: Globalstar Inc., -15.32%
$AMC: AMC Entertainment Holdings Inc - Class A, 8.77%
$ACIU: AC Immune SA, 16.31%
$PLTR: Palantir Technologies Inc - Class A, 2.25%
$AAPL: Apple Inc, -0.84%
$XELA: Exela Technologies Inc, 12.61%
$WFC: Wells Fargo & Co., -5.60%
$BAC: Bank Of America Corp., 0.22%
$AMD: Advanced Micro Devices Inc., -0.54%
🦎Trending Crypto:
━━━━━━━━━━━━━━━━
$$NFD: Feisty Doge NFT, -34.32%
$$SLP: Smooth Love Potion, -13.02%
$$PVU: Plant vs Undead Token, -1.27%
$$XED: Exeedme, 1.02%
$$SOL: Solana, -3.95%
$$BNB: Binance Coin, -0.25%
$$EWT: Energy Web Token, 17.72%
</pre>
</div>
</div>
## /help :robot:
Just a simple command to get help in app. Returns a more summarized version of this page.
<div class="phone">
<div class="messages-wrapper">
<div class="message to">
/help
</div>
<div class="message from">
The current stock price of Tesla Inc is $664.315, the stock is
currently down -0.99%
</div>
</div>
</div>
## `/status` :robot:
This command is to get diagnostic information about the bot and the services it is dependant on in order to operate. Any issues should be reported to me. [Contact](contact.md)
<div class="phone">
<div class="messages-wrapper">
<div class="message to">
/status
</div>
<pre class="message from">
Bot Status:
It took 0.783369 seconds for the bot to get your message.
Stock Market Data:
marketdata.app is currently not reporting any issues with its API.
Cryptocurrency Data:
CoinGecko API responded that it was OK in 0.160962 Seconds.
</pre>
</div>
</div>
## Inline Features :fontawesome-brands-telegram: :material-currency-btc: :bank: :dollar:
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
want the bot will send a message as you in that chat with the latest stock price.
The bot also looks at every message in any chat it is in for stock symbols.Symbols start with a
`$` followed by the stock symbol. For example:$tsla would return price information for Tesla Motors.
Symbols are used in headings to denote what platforms and symbol types a command supports.
- Telegram Only :fontawesome-brands-telegram-plane:
- Discord Only :fontawesome-brands-discord:
- Bot Commands :robot:
- Cryptocurrency Support :material-currency-btc:
- Stock Market Support :bank:
- OTC Support :dollar:
## Symbol Detection :material-currency-btc: :bank: :dollar:
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.
<div class="phone">
<div class="messages-wrapper">
<div class="message to">
I wonder how $tsla is affecting the price of $$btc
</div>
<div class="message from">
The current stock price of Tesla Inc is $866.57, the stock is currently up 1.68%
</div>
<div class="message from">
The current price of Bitcoin is $34,815, the coin is currently down -0.151% for today
</div>
</div>
</div>
## `/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.
<div class="phone">
<div class="messages-wrapper">
<div class="message to">
/donate
</div>
<div class="message from">
The current stock price of Tesla Inc is $664.315, the stock is
currently down -0.99%
</div>
</div>
</div>
## `/intra [symbol]` :bank: :material-currency-btc:
This command makes a chart of a stocks movement since the last market open, or the last 24 hours for cryptocurrency.
<div class="phone">
<div class="messages-wrapper">
<div class="message to">
/intra $astr
</div>
<div class="message from">
<img src="/img/TgIntraChat.jpg" alt="Tesla Motors Chart" />
<p>Intraday chart for $ASTR from 06 Jul at 09:30 to 06 Jul at 15:59</p>
<p>The current stock price of Astra Space Inc - Class A is $12.47, the stock is currently down -19.39%</p>
</div>
</div>
</div>
## `/chart [symbol]` :bank: :material-currency-btc:
This command makes a chart of the last 1 month of trading data up until the day before. For example running it on May 5th creates a chart from April 5th to May 4th.
<div class="phone">
<div class="messages-wrapper">
<div class="message to">
/intra $astr
</div>
<div class="message from">
<img src="/img/TgChartChat.jpg" alt="Tesla Motors Chart" />
<p>1 Month chart for Ethereum from 07, Jun 2021 to 07, Jul 2021</p>
<p>The current price of Ethereum is $2,389.62, the coin is currently up 2.485% for today</p>
</div>
</div>
</div>
## `/trending`
Gets the latest trending stocks and their change in price
<div class="phone">
<div class="messages-wrapper">
<div class="message to">
/trending
</div>
<pre class="message from">
🦍Trending on the Stock Bot:
━━━━━━━━━━━━━━━━━━━━━━━━━━
$GME: Gamestop Corporation - Class A, 5.06%
$MMAT: Meta Materials Inc, 4.77%
$$BTC: Bitcoin, -0.83%
$$ETH: Ethereum, 6.06%
$$DOGE: Binance-Peg Dogecoin, 0.14%
💵Trending Stocks:
━━━━━━━━━━━━━━━━
$BBIG: Vinco Ventures Inc, 15.44%
$GSAT: Globalstar Inc., -15.32%
$AMC: AMC Entertainment Holdings Inc - Class A, 8.77%
$ACIU: AC Immune SA, 16.31%
$PLTR: Palantir Technologies Inc - Class A, 2.25%
$AAPL: Apple Inc, -0.84%
$XELA: Exela Technologies Inc, 12.61%
$WFC: Wells Fargo & Co., -5.60%
$BAC: Bank Of America Corp., 0.22%
$AMD: Advanced Micro Devices Inc., -0.54%
🦎Trending Crypto:
━━━━━━━━━━━━━━━━
$$NFD: Feisty Doge NFT, -34.32%
$$SLP: Smooth Love Potion, -13.02%
$$PVU: Plant vs Undead Token, -1.27%
$$XED: Exeedme, 1.02%
$$SOL: Solana, -3.95%
$$BNB: Binance Coin, -0.25%
$$EWT: Energy Web Token, 17.72%
</pre>
</div>
</div>
## /help :robot:
Just a simple command to get help in app. Returns a more summarized version of this page.
<div class="phone">
<div class="messages-wrapper">
<div class="message to">
/help
</div>
<div class="message from">
The current stock price of Tesla Inc is $664.315, the stock is
currently down -0.99%
</div>
</div>
</div>
## `/status` :robot:
This command is to get diagnostic information about the bot and the services it is dependant on in order to operate. Any issues should be reported to me. [Contact](contact.md)
<div class="phone">
<div class="messages-wrapper">
<div class="message to">
/status
</div>
<pre class="message from">
Bot Status:
It took 0.783369 seconds for the bot to get your message.
Stock Market Data:
marketdata.app is currently not reporting any issues with its API.
Cryptocurrency Data:
CoinGecko API responded that it was OK in 0.160962 Seconds.
</pre>
</div>
</div>
## Inline Features :fontawesome-brands-telegram: :material-currency-btc: :bank: :dollar:
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
want the bot will send a message as you in that chat with the latest stock price.
The bot also looks at every message in any chat it is in for stock symbols.Symbols start with a
`$` followed by the stock symbol. For example:$tsla would return price information for Tesla Motors.

View File

@ -1,8 +1,8 @@
# I Would Love to Hear From You!
Your feedback and experience with Simple Stock Bot is invaluable. Whether you've encountered a bug, have a suggestion for improvement, or just want to share your experience, I'm all ears. Here are several ways you can get in touch:
- **Telegram**: Drop me a message on [Telegram](https://t.me/MisterBiggs).
- **Discord**: Feel free to reach out on Discord at `MisterBiggs#0465`.
- **Twitter**: Send me a tweet on [Twitter](https://twitter.com/AnsonBiggs).
- **GitLab**: For technical issues or feature requests, feel free to open an issue on our [GitLab Repository](https://gitlab.com/simple-stock-bots/simple-telegram-stock-bot).
# I Would Love to Hear From You!
Your feedback and experience with Simple Stock Bot is invaluable. Whether you've encountered a bug, have a suggestion for improvement, or just want to share your experience, I'm all ears. Here are several ways you can get in touch:
- **Telegram**: Drop me a message on [Telegram](https://t.me/MisterBiggs).
- **Discord**: Feel free to reach out on Discord at `MisterBiggs#0465`.
- **Twitter**: Send me a tweet on [Twitter](https://twitter.com/AnsonBiggs).
- **GitLab**: For technical issues or feature requests, feel free to open an issue on our [GitLab Repository](https://gitlab.com/simple-stock-bots/simple-telegram-stock-bot).

View File

@ -1,21 +1,21 @@
# Support Simple Stock Bot
Running Simple Stock Bot incurs a yearly expense of about $420, covering server costs and premium market data subscription from [marketdata.app](https://dashboard.marketdata.app/marketdata/aff/go/misterbiggs?keyword=repo). Every donation helps in maintaining the bot and ensuring its continued availability for all users.
Your support through [Buy Me A Coffee](https://www.buymeacoffee.com/Anson) is greatly appreciated, which accepts both PayPal and Credit Card donations.
For Telegram users, a convenient way to donate is by using the `/donate` [command](commands.md#donate-amount-in-usd).
Should you have any inquiries, feel free to get in [touch](contact.md).
## Additional Support:
Your engagement also counts as support! Here are other ways to contribute:
- Stay updated by following me on [Twitter](https://twitter.com/AnsonBiggs).
- Contribute to the project or star it on [GitLab](https://gitlab.com/simple-stock-bots).
- If you plan to host your own bot, consider using my referral links:
- [marketdata.app](https://dashboard.marketdata.app/marketdata/aff/go/misterbiggs?keyword=web)
- [DigitalOcean](https://m.do.co/c/6b5df7ef55b6)
Your support in any form is immensely appreciated and helps in keeping Simple Stock Bot operational and free for everyone.
# Support Simple Stock Bot
Running Simple Stock Bot incurs a yearly expense of about $420, covering server costs and premium market data subscription from [marketdata.app](https://dashboard.marketdata.app/marketdata/aff/go/misterbiggs?keyword=repo). Every donation helps in maintaining the bot and ensuring its continued availability for all users.
Your support through [Buy Me A Coffee](https://www.buymeacoffee.com/Anson) is greatly appreciated, which accepts both PayPal and Credit Card donations.
For Telegram users, a convenient way to donate is by using the `/donate` [command](commands.md#donate-amount-in-usd).
Should you have any inquiries, feel free to get in [touch](contact.md).
## Additional Support:
Your engagement also counts as support! Here are other ways to contribute:
- Stay updated by following me on [Twitter](https://twitter.com/AnsonBiggs).
- Contribute to the project or star it on [GitLab](https://gitlab.com/simple-stock-bots).
- If you plan to host your own bot, consider using my referral links:
- [marketdata.app](https://dashboard.marketdata.app/marketdata/aff/go/misterbiggs?keyword=web)
- [DigitalOcean](https://m.do.co/c/6b5df7ef55b6)
Your support in any form is immensely appreciated and helps in keeping Simple Stock Bot operational and free for everyone.

View File

@ -1,47 +1,47 @@
# Self-Hosting Guide
This guide provides step-by-step instructions for setting up and running this project on your local machine, whether for development, testing, or personal use.
## Pre-requisites
Ensure the following are installed or obtained before proceeding:
- **[Docker](https://hub.docker.com/?overlay=onboarding)**: The project is containerized using Docker Compose, allowing it to run on any system with Docker installed.
- **API Keys**:
- **Telegram**: Obtain a free API key by interacting with [BotFather](https://telegram.me/botfather). More details [here](https://core.telegram.org/bots#3-how-do-i-create-a-bot).
- **Discord**: Get a free API key at [https://discord.com/developers](https://discord.com/developers).
- **[marketdata.app](https://dashboard.marketdata.app/marketdata/aff/go/misterbiggs?keyword=web)**: Sign up to get an API key. A free tier is available and should suffice for private groups. More details [here](https://dashboard.marketdata.app/marketdata/aff/go/misterbiggs?keyword=repo).
!!! tip
The bot will still operate without a [marketdata.app](https://dashboard.marketdata.app/marketdata/aff/go/misterbiggs?keyword=repo) key but will revert to using only cryptocurrency data.
!!! note
To enable donation acceptance, obtain a Stripe API key and provide a `STRIPE` key to your bot. [https://stripe.com/]()
## Setup Instructions
1. **Download/Clone the Repository**:
- Download or clone this repository to your local machine.
2. **Configure Environment Variables**:
- Navigate to the project directory and locate the `.env` file.
- Fill in the `.env` file with your obtained API keys:
```plaintext
MARKETDATA=your_marketdata_api_key
STRIPE=your_stripe_api_key
TELEGRAM=your_telegram_api_key
DISCORD=your_discord_api_key
```
Alternatively, pass the variables using Docker Compose environment variables or command-line arguments.
3. **Build and Run the Bot:**
- Open a terminal in the project directory.
- Build and run both bots using Docker Compose:
```bash
docker-compose up
```
Now, your bot(s) should be up and running! If you're unfamiliar with Docker, reviewing the [Docker documentation](https://docs.docker.com/) is highly recommended to gain better control over your bot and understand Docker commands better.
# Self-Hosting Guide
This guide provides step-by-step instructions for setting up and running this project on your local machine, whether for development, testing, or personal use.
## Pre-requisites
Ensure the following are installed or obtained before proceeding:
- **[Docker](https://hub.docker.com/?overlay=onboarding)**: The project is containerized using Docker Compose, allowing it to run on any system with Docker installed.
- **API Keys**:
- **Telegram**: Obtain a free API key by interacting with [BotFather](https://telegram.me/botfather). More details [here](https://core.telegram.org/bots#3-how-do-i-create-a-bot).
- **Discord**: Get a free API key at [https://discord.com/developers](https://discord.com/developers).
- **[marketdata.app](https://dashboard.marketdata.app/marketdata/aff/go/misterbiggs?keyword=web)**: Sign up to get an API key. A free tier is available and should suffice for private groups. More details [here](https://dashboard.marketdata.app/marketdata/aff/go/misterbiggs?keyword=repo).
!!! tip
The bot will still operate without a [marketdata.app](https://dashboard.marketdata.app/marketdata/aff/go/misterbiggs?keyword=repo) key but will revert to using only cryptocurrency data.
!!! note
To enable donation acceptance, obtain a Stripe API key and provide a `STRIPE` key to your bot. [https://stripe.com/]()
## Setup Instructions
1. **Download/Clone the Repository**:
- Download or clone this repository to your local machine.
2. **Configure Environment Variables**:
- Navigate to the project directory and locate the `.env` file.
- Fill in the `.env` file with your obtained API keys:
```plaintext
MARKETDATA=your_marketdata_api_key
STRIPE=your_stripe_api_key
TELEGRAM=your_telegram_api_key
DISCORD=your_discord_api_key
```
Alternatively, pass the variables using Docker Compose environment variables or command-line arguments.
3. **Build and Run the Bot:**
- Open a terminal in the project directory.
- Build and run both bots using Docker Compose:
```bash
docker-compose up
```
Now, your bot(s) should be up and running! If you're unfamiliar with Docker, reviewing the [Docker documentation](https://docs.docker.com/) is highly recommended to gain better control over your bot and understand Docker commands better.

View File

@ -1,31 +1,31 @@
# Elevate Your Groupchats with Real-time Stock Insights
Discover a new level of financial discussion with Simple Stock Bot, your go-to solution for real-time stock market and cryptocurrency insights within your Telegram or Discord group chats. Transform your everyday discussions into an interactive financial exploration experience. With Simple Stock Bot, keeping up with the stock market or cryptocurrency trends has never been more seamless and engaging.
## [Commands](commands.md)
### Real-Time Stock and Cryptocurrency Updates
- Get live price updates of stocks and cryptocurrencies.
- Symbol Detection: Use `$` for stocks and `$$` for cryptocurrencies, e.g., `$tsla` for Tesla and `$$btc` for Bitcoin.
### Intraday and Historical Data Visualization
- `/intra`: View a stock's movement since the last market open or a cryptocurrency's 24-hour chart.
- `/chart`: Provides a chart of the last month's trading data up till the day before.
### Trending Assets Awareness
- `/trending`: Discover the latest trending stocks and cryptocurrencies and their price changes.
### In-App Assistance and Support
- `/help`: Provides a quick summary of available commands for easy reference.
- `/donate`: Support the maintenance of the bot to ensure continued free access.
### User-Friendly Interaction
- Easy symbol and command usage for a smooth user experience.
- Engage with a community of financial enthusiasts and share insights effortlessly.
## [Contact](contact.md)
Need assistance or have inquiries? Feel free to reach out and I'll be happy to help.
## Powered by MarketData.app
Simple Stock Bots is able to provide real-time stock market insights thanks to the data supplied by [MarketData.app](https://dashboard.marketdata.app/marketdata/aff/go/misterbiggs?keyword=web). MarketData.app delivers accurate and up-to-date financial data, fueling the bot's capabilities in delivering timely stock quotes, charts, and other market-related information directly to your Telegram or Discord groups. The robust data infrastructure provided by MarketData.app not only ensures the reliability and accuracy of the information you receive but also enables the offering of Simple Stock Bots for free to all users. By leveraging MarketData.app's comprehensive financial data, the goal is to foster informed financial discussions and make market monitoring an effortless and accessible experience for everyone.
# Elevate Your Groupchats with Real-time Stock Insights
Discover a new level of financial discussion with Simple Stock Bot, your go-to solution for real-time stock market and cryptocurrency insights within your Telegram or Discord group chats. Transform your everyday discussions into an interactive financial exploration experience. With Simple Stock Bot, keeping up with the stock market or cryptocurrency trends has never been more seamless and engaging.
## [Commands](commands.md)
### Real-Time Stock and Cryptocurrency Updates
- Get live price updates of stocks and cryptocurrencies.
- Symbol Detection: Use `$` for stocks and `$$` for cryptocurrencies, e.g., `$tsla` for Tesla and `$$btc` for Bitcoin.
### Intraday and Historical Data Visualization
- `/intra`: View a stock's movement since the last market open or a cryptocurrency's 24-hour chart.
- `/chart`: Provides a chart of the last month's trading data up till the day before.
### Trending Assets Awareness
- `/trending`: Discover the latest trending stocks and cryptocurrencies and their price changes.
### In-App Assistance and Support
- `/help`: Provides a quick summary of available commands for easy reference.
- `/donate`: Support the maintenance of the bot to ensure continued free access.
### User-Friendly Interaction
- Easy symbol and command usage for a smooth user experience.
- Engage with a community of financial enthusiasts and share insights effortlessly.
## [Contact](contact.md)
Need assistance or have inquiries? Feel free to reach out and I'll be happy to help.
## Powered by MarketData.app
Simple Stock Bots is able to provide real-time stock market insights thanks to the data supplied by [MarketData.app](https://dashboard.marketdata.app/marketdata/aff/go/misterbiggs?keyword=web). MarketData.app delivers accurate and up-to-date financial data, fueling the bot's capabilities in delivering timely stock quotes, charts, and other market-related information directly to your Telegram or Discord groups. The robust data infrastructure provided by MarketData.app not only ensures the reliability and accuracy of the information you receive but also enables the offering of Simple Stock Bots for free to all users. By leveraging MarketData.app's comprehensive financial data, the goal is to foster informed financial discussions and make market monitoring an effortless and accessible experience for everyone.

View File

@ -1,40 +1,40 @@
/* https://codepen.io/RG/pen/bdfDI */
.phone {
background: none repeat scroll 0 0 #fff;
/*border-left: 1px solid #ccc;
border-right: 1px solid #ccc;*/
color: #ffffff;
font-family: sans-serif;
line-height: 20px;
width: 80%;
margin: 0 auto;
overflow-x: hidden;
position: relative;
border-radius: 10px;
margin: 50px;
}
.messages-wrapper {
position: relative;
}
.message {
margin: 10px;
padding: 15px 20px;
position: relative;
overflow-x: auto;
}
.message.to {
border-radius: 20px 0px 20px 20px;
background-color: #2095fe;
color: #fff;
margin-left: 20%;
}
.message.from {
border-radius: 20px 20px 20px 0px;
background-color: #e5e4e9;
color: #363636;
margin-right: 20%;
}
.message.to + .message.to,
.message.from + .message.from {
margin-top: -7px;
}
/* https://codepen.io/RG/pen/bdfDI */
.phone {
background: none repeat scroll 0 0 #fff;
/*border-left: 1px solid #ccc;
border-right: 1px solid #ccc;*/
color: #ffffff;
font-family: sans-serif;
line-height: 20px;
width: 80%;
margin: 0 auto;
overflow-x: hidden;
position: relative;
border-radius: 10px;
margin: 50px;
}
.messages-wrapper {
position: relative;
}
.message {
margin: 10px;
padding: 15px 20px;
position: relative;
overflow-x: auto;
}
.message.to {
border-radius: 20px 0px 20px 20px;
background-color: #2095fe;
color: #fff;
margin-left: 20%;
}
.message.from {
border-radius: 20px 20px 20px 0px;
background-color: #e5e4e9;
color: #363636;
margin-right: 20%;
}
.message.to + .message.to,
.message.from + .message.from {
margin-top: -7px;
}

View File

@ -1,79 +1,79 @@
site_name: Simple Stock Bot
site_url: https://simplestockbot.com
edit_uri: /simple-stock-bots/site/tree/master/site
repo_url: https://gitlab.com/simple-stock-bots/simple-telegram-stock-bot
repo_name: Simple Stock Bots
site_description: Simple Discord and Telegram chat bots for Stock Market Data.
site_author: Anson Biggs
copyright: <a href="https://ansonbiggs.com">Anson Biggs</a> 2018 </br> Available Under an <a href="/LICENSE/">MIT LICENSE</a> </br>
nav:
- Home: index.md
- Commands: commands.md
- Self-Host: host.md
- Donate: donate.md
- Contact: contact.md
- Blog: /blog
theme:
name: material
language: en
features:
- navigation.instant
- navigation.tracking
- navigation.tabs
- navigation.tabs.sticky
- content.code.copy
icon:
logo: material/robot-love
palette:
- media: "(prefers-color-scheme: light)"
primary: green
scheme: default
toggle:
icon: material/lightbulb-outline
name: Switch to dark mode
- media: "(prefers-color-scheme: dark)"
primary: green
scheme: slate
toggle:
icon: material/lightbulb
name: Switch to light mode
extra:
social:
- icon: fontawesome/solid/house
link: https://simplestockbot.com/
- icon: fontawesome/brands/telegram
link: https://t.me/SimpleStockBot
name: Get the Telegram bot
- icon: fontawesome/brands/discord
link: https://discordapp.com/api/oauth2/authorize?client_id=532045200823025666&permissions=36507338752&scope=bot
name: Get the Discord Bot
- icon: material/chart-line-stacked
link: https://dashboard.marketdata.app/marketdata/aff/go/misterbiggs?keyword=web
name: MarketData.app for stock data
extra_css:
- stylesheets/phone.css
plugins:
- search
- social
- blog
markdown_extensions:
- attr_list
- pymdownx.emoji:
emoji_index: !!python/name:materialx.emoji.twemoji
emoji_generator: !!python/name:materialx.emoji.to_svg
- admonition
- pymdownx.details
- pymdownx.superfences
site_name: Simple Stock Bot
site_url: https://simplestockbot.com
edit_uri: /simple-stock-bots/site/tree/master/site
repo_url: https://gitlab.com/simple-stock-bots/simple-telegram-stock-bot
repo_name: Simple Stock Bots
site_description: Simple Discord and Telegram chat bots for Stock Market Data.
site_author: Anson Biggs
copyright: <a href="https://ansonbiggs.com">Anson Biggs</a> 2018 </br> Available Under an <a href="/LICENSE/">MIT LICENSE</a> </br>
nav:
- Home: index.md
- Commands: commands.md
- Self-Host: host.md
- Donate: donate.md
- Contact: contact.md
- Blog: /blog
theme:
name: material
language: en
features:
- navigation.instant
- navigation.tracking
- navigation.tabs
- navigation.tabs.sticky
- content.code.copy
icon:
logo: material/robot-love
palette:
- media: "(prefers-color-scheme: light)"
primary: green
scheme: default
toggle:
icon: material/lightbulb-outline
name: Switch to dark mode
- media: "(prefers-color-scheme: dark)"
primary: green
scheme: slate
toggle:
icon: material/lightbulb
name: Switch to light mode
extra:
social:
- icon: fontawesome/solid/house
link: https://simplestockbot.com/
- icon: fontawesome/brands/telegram
link: https://t.me/SimpleStockBot
name: Get the Telegram bot
- icon: fontawesome/brands/discord
link: https://discordapp.com/api/oauth2/authorize?client_id=532045200823025666&permissions=36507338752&scope=bot
name: Get the Discord Bot
- icon: material/chart-line-stacked
link: https://dashboard.marketdata.app/marketdata/aff/go/misterbiggs?keyword=web
name: MarketData.app for stock data
extra_css:
- stylesheets/phone.css
plugins:
- search
- social
- blog
markdown_extensions:
- attr_list
- pymdownx.emoji:
emoji_index: !!python/name:materialx.emoji.twemoji
emoji_generator: !!python/name:materialx.emoji.to_svg
- admonition
- pymdownx.details
- pymdownx.superfences

View File

@ -1,5 +1,5 @@
mkdocs-material==9.4.4
# Required for Social Cards
Pillow==10.0.1
mkdocs-material==9.4.4
# Required for Social Cards
Pillow==10.0.1
CairoSVG==2.7.1