Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Currency Bot 💰📈

Currency Bot — это удобный и быстрый Telegram-бот для получения актуальных и исторических данных о курсах валют относительно доллара США. Также бот умеет строить графики изменения курса, что позволяет анализировать тренды.


📋 Основные функции

  1. Актуальный курс валют
    Узнайте текущий курс выбранной валюты по отношению к доллару США (USD).

  2. Исторические данные
    Получите информацию о курсах валют за определённый период времени.

  3. Графики изменения курса
    Постройте график изменения курса валюты за указанный интервал времени.


📊 Пример графика

График изменения курса RUB за интервал времени с 2001-01-01 по 2002-01-01:
Пример изображения


📜 Доступные команды

  • /start
    Команда запускает телеграм-бота.
    Start bot

  • /change_mode
    Команда предлагает изменить режим работы.
    Change mode

  • /change_currency
    Команда предлагает изменить валюту.
    Change currency


🔧 Предварительные настройки бота

  1. Необходимо создать бота в Telegram и получить его токен, используя сервис BotFather: Перейти к BotFather.

  2. Добавьте команды /start, /change_mode и /change_currency, используя BotFather, к своему созданному боту.
    Пример того, как должны выглядеть команды в боте

  3. Зарегистрируйтесь на сервисе FreecurrencyAPI, чтобы получить API Key.


📦 Установка и запуск

  1. Клонируйте репозиторий:
    git clone https://github.com/goroutiner/currency_bot

  1. Перейдите в рабочую директорию с проектом:

    cd  currency_bot
  2. Открываем в рабочей директории Dockerfile записываем свой токен и Api Key в переменные окружения BOT_TOKEN и API_KEY

     ENV BOT_TOKEN=""
     ENV API_KEY=""
  3. Собираем Docker-образ с телеграм-ботом:

    docker build -t currency_bot:v1.0 .
  4. Запускаем Docker-образ:

    docker run -it -p 8080:8080 currency_bot:v1.0
  5. Чтобы прекратить работу телеграм-бота, необходимо остановить запущенный контейнер, для этого достаточно нажать сочетание клавиш Ctrl+C в открытом терминале.

  6. Когда ваш Docker-контейнер запущен, телеграм-бот готов к использованию 💫 Открывайте своего бота в телеграмме и пользуйтесь его функционалом 🤑

🛠️ Технические ресурсы

  • Язык разработки: Golang
  • Библиотека для взаимодействия с Telegram API: tucnak/telebot.
  • API для курсов валют: freecurrencyapi.com
  • Библиотека для графиков: gonum/plot
  • Библиотека форматирования валют: bojanz/currency

About

Telegram bot works with the current exchange rate and visualizes the indicators using graphs.

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Used by

Contributors

Languages