summaryrefslogtreecommitdiff
path: root/README.md
blob: a6395773edc685258203bb9e38e02b3f204cb620 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
<h1 align="center">Welcome to Binance Spot Order Notifier via Telegram👋</h1>
<h2>Binance does not currently offer notification when order created, cancelled or fulfilled etc.. With this repo you will receive telegram notification for your binance spot order status.</h2>
<p>
  <img alt="Version" src="https://img.shields.io/badge/version-1.0-blue.svg?cacheSeconds=2592000" />
  <a href="https://github.com/PiyushDixit96/binance-order-notifier/blob/main/LICENSE" target="_blank">
    <img alt="License: MIT" src="https://img.shields.io/badge/License-MIT-yellow.svg" />
  </a>
  <a href="https://twitter.com/PiyushDixit_" target="_blank">
    <img alt="Twitter: PiyushDixit_" src="https://img.shields.io/twitter/follow/PiyushDixit_.svg?style=social" />
  </a>
</p>

> This repo send TELEGRAM ALERTS for BINANCE ORDER STATUS like CREATED, PARTIALLY FILLED, FILLED, CANCELLED, PENDING CANCEL, REJECTED, EXPIRED etc.

<h2>Deploy to Heroku</h2>

[![Deploy](https://www.herokucdn.com/deploy/button.svg)](https://heroku.com/deploy?template=https://github.com/PiyushDixit96/binance-order-notifier)


<h2>Setup before Depoly to Heroku</h2>

<h4>SETUP TELEGRAM BOT</h4>

1. Create account on Telegram (skip if you have)
2. Create Telegram Bot Goto [Bot help](https://core.telegram.org/bots#3-how-do-i-create-a-bot) follow steps at the END Copy **TOKEN**
3. Open created Bot and click **START**
4. Goto [@getuseridbot](https://t.me/getuseridbot) and and click **START** and copy **NUMERIC VALUE** this is your **CHAT ID**

<h4>SETUP BINANCE ACCOUNT</h4>

1. [Signup](https://www.binance.com/en/register?ref=35219097) for Binance (skip if you have)
2. Enable Two-factor Authentication (skip if you done already)
3. Go API Center, [Create New](https://www.binance.com/en/my/settings/api-management?ref=35219097) Api Key and follow steps and at the END, SET API restrictions to  **ENABLE READING ** only
4. **Copy API Key and Secret Key** save and Nodepad for later use

<h4>DEPOLY TO HEROKU</h4>

1. Create account on Heroku (skip if you have)
2. Login to Heroku (if your are not)
3. Click [![Deploy](https://www.herokucdn.com/deploy/button.svg)](https://heroku.com/deploy?template=https://github.com/PiyushDixit96/binance-order-notifier)

![fullUntitled](https://user-images.githubusercontent.com/79581397/117697809-89587b00-b1e0-11eb-98d3-3086f973ce84.jpg)

5. Give any name in "App name" field
6. Fill required fields in "Config Vars"
7. Click "Depoly app"
8. When you see " Your app was successfully deployed. " your bot started automatically.
9. `important step for preventing idling heroku app`. Click "View" and copy URL when new tab open in your browser

![DSCapture](https://user-images.githubusercontent.com/79581397/117698015-d1779d80-b1e0-11eb-8b57-0224ab96e3ee.JPG)

10. Goto [UptimeRobot](https://uptimerobot.com/) and Create free account
11. Click "Add New Monitor"
12. Monitor Type : HTTPS
13. Friendly Name : any name
14. URL (or IP): paste URL of your app. (you copy URL in Step 8)
15. Monitoring Interval : 20 minutes
16. Click " Create Monitor "
17. Now Enjoy
------------
### Run Locally
- Download and install NodeJs
- Download Repo and open Repo root folder.
- Create .env in root folder and copy , paste below code
 ```sh
TELEGRAM_TOKEN="you telegram token"
TELEGRAM_CHAT_ID="your telegram chat id"
BINANCE_API_KEY="binance api key"
BINANCE_SECRET_KEY="binance api sercet"
TIME_ZONE_STRING="your time zone string"

Time zone string example "Asia/Kolkata"
```
- Edit required fields in .env file and save
- Open terminal on current folder 
- Run this command to install `npm install`
- Run this to start `npm start`

## Author

👤 **Piyush Dixit**

* Twitter: [@PiyushDixit\_](https://twitter.com/PiyushDixit_)
* Github: [@PiyushDixit96](https://github.com/PiyushDixit96)
* Telegram: [@Killer_PD](https://t.me/Killer_PD)

## Show your support

Give a ⭐️ if this project helped you!

## 📝 License

Copyright © 2021 [@PiyushDixit96](https://github.com/PiyushDixit96).<br />
This project is [MIT](https://github.com/PiyushDixit96/binance-order-notifier/blob/main/LICENSE) licensed.
***