realdollar: A Python repository from Merkousha

Real Dollar Bot

An Awesome bot to detect current Iranian Exchange rates, crypto prices, and ...

Explore the docs »

View Demo . Report Bug . Request Feature

About the Project
Built With
Getting Started
- Prerequisites
- Installation
Usage
Roadmap
Contributing
License
Authors
Acknowledgements

About The Project

RealDollarBot is a Telegram bot that provides various services related to financial markets. Here's a description of its services:

1- Market Overview Report: /whatsup

This command provides a general overview of the market. It offers a comprehensive report on the current market conditions, including information on various financial assets such as stocks, commodities, and currencies.

2- Currency Market Report: /currency

By using the "/currency" command, users can access a detailed report on the currency market. This report provides information about different currencies, their exchange rates, and any significant changes or trends in the currency market.

3- Cryptocurrency Market Report: /Crypto

The "/Crypto" command allows users to obtain a report on the status of various cryptocurrencies. This report includes information about the prices, market capitalization, trading volumes, and other relevant data related to cryptocurrencies.

4- Gold Market Report: /Gold

With the "/Gold" command, users can receive a report on the current status of the gold market. This report provides information about the price of gold, any recent fluctuations, and key factors influencing the gold market.

5- Today's Dollar Chart: /todaydollarchart

By entering the "/todaydollarchart" command, users can access a chart that displays the current value of the dollar. This chart provides a visual representation of the dollar's performance against other currencies or financial assets for the current day.

6- Weekly Dollar Chart: /weeklydollarchart

The "/weeklydollarchart" command allows users to view a chart displaying the dollar's performance over the course of a week. This chart provides insights into the dollar's fluctuations and trends over a broader timeframe.

These services offered by RealDollarBot aim to provide users with valuable information and insights into the financial markets, enabling them to make informed decisions regarding investments, currency exchanges, and more.

ربات تلگرامی realdollarbot یک ربات کاربردی است که امکانات مختلفی را در خصوص بازار ارز، رمز ارزها، بازار طلا و نمودار دلار فراهم می‌کند. در زیر به شرح هر سرویس بخشی از این ربات می‌پردازیم:

گزارش کلی بازار (/whatsup):
این سرویس به شما امکان می‌دهد یک گزارش کلی از وضعیت کل بازار ارز را دریافت کنید. با فراخوانی این دستور، شما می‌توانید اطلاعاتی مانند قیمت دلار، یورو و دیگر ارزها در بازار بدست آورید.

گزارش بازار ارز (/currency):
این سرویس به شما اطلاعات دقیقتری درباره بازار ارز ارائه می‌دهد. با استفاده از دستور "/currency"، می‌توانید قیمت‌های دقیق و جدیدترین تغییرات ارزها را مشاهده کنید. این شامل ارزهای مختلف مانند دلار آمریکا، یورو، پوند بریتانیا و سایر ارزها می‌شود.

گزارش وضعیت رمز ارزها (/Crypto):
این سرویس به شما امکان می‌دهد وضعیت رمز ارزها را در بازار بررسی کنید. با استفاده از دستور "/Crypto"، می‌توانید قیمت‌ها و تغییرات اخیر در رمز ارزهای مشهور مانند بیتکوین، اتریوم، ریپل و سایر رمز ارزها را مشاهده کنید.

گزارش وضعیت بازار طلا (/Gold):
این سرویس به شما امکان می‌دهد وضعیت بازار طلا را بررسی کنید. با استفاده از دستور "/Gold"، می‌توانید قیمت طلا و تغییرات اخیر در بازار طلا را مشاهده کنید.

نمودار دلار امروز (/todaydollarchart):

این سرویس به شما امکان می‌دهد نمودار قیمت دلار امروز را مشاهده کنید. با استفاده از دستور "/todaydollarchart"، شما می‌توانید نموداری که نشان‌دهنده تغییرات قیمت دلار در طول روز است را ببینید. این نمودار ممکن است شامل قیمت آغازین، قیمت بالاترین، قیمت پایین‌ترین و قیمت پایانی روز باشد.

نمودار دلار هفته (/weeklydollarchart):
با استفاده از این سرویس، شما می‌توانید نمودار قیمت دلار در طول هفته را مشاهده کنید. با فراخوانی دستور "/weeklydollarchart"، شما می‌توانید نموداری که تغییرات قیمت دلار در طول هفته را نشان می‌دهد را ببینید. این نمودار می‌تواند اطلاعاتی مانند قیمت آغازین هر روز، قیمت بالاترین، قیمت پایین‌ترین و قیمت پایانی هر روز را نشان دهد.

با استفاده از این سرویس‌ها، کاربران می‌توانند اطلاعات و آمار مربوط به بازار ارز، رمز ارزها، بازار طلا و نمودار دلار را به صورت سریع و آسان دریافت کنند و با توجه به این اطلاعات، تصمیمات مالی خود را بهبود ببخشند.

Built With

Python

Package Version
---------------------------- --------------------
beautifulsoup4 4.11.2
bs4 0.0.1
cachetools 5.3.0
feedparser 6.0.10
numpy 1.23.5
pandas 1.5.3
persiantools 3.0.1
PyDispatcher 2.0.7
python-telegram-bot 20.1
pytz 2023.2
requests 2.28.2
SQLAlchemy 2.0.5.post1

Getting Started

1- in the first step, you must install python and the required modules.
2- set your telegram bot token in this module :
https://github.com/Merkousha/realdollar/blob/main/dollar/modules/Common/config_texts.py

Prerequisites

Run the following command to install all the required modules listed in the requirements.txt file:

pip install -r requirements.txt

Installation

this step will complete in the future

Usage

this step will complete in the future

Roadmap

See the open issues for a list of proposed features (and known issues).

Contributing

Contributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have suggestions for adding or removing projects, feel free to open an issue to discuss it, or directly create a pull request after you edit the README.md file with necessary changes.
Please make sure you check your spelling and grammar.
Create individual PR for each suggestion.
Please also read through the Code Of Conduct before posting your first idea as well.

Creating A Pull Request

Fork the Project
Create your Feature Branch (git checkout -b feature/AmazingFeature)
Commit your Changes (git commit -m 'Add some AmazingFeature')
Push to the Branch (git push origin feature/AmazingFeature)
Open a Pull Request

Merkousha/realdollar