{"id":17826960,"url":"https://github.com/arabacibahadir/sup-res","last_synced_at":"2025-03-19T01:30:51.869Z","repository":{"id":37290679,"uuid":"401112490","full_name":"arabacibahadir/sup-res","owner":"arabacibahadir","description":"A great companion for finding key support and resistance levels on financial charts, cryptocurrencies.","archived":false,"fork":false,"pushed_at":"2023-04-20T09:08:35.000Z","size":2115,"stargazers_count":172,"open_issues_count":1,"forks_count":40,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-03-17T02:11:24.591Z","etag":null,"topics":["algotrade","analysis","binance","binance-api","bitcoin","cryptocurrency","data-science","finance","pandas","pinescript","python","stock","telegram","telegram-bot","tradingview"],"latest_commit_sha":null,"homepage":"https://arabacibahadir.github.io/sup-res/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/arabacibahadir.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-08-29T18:21:10.000Z","updated_at":"2025-03-11T19:17:00.000Z","dependencies_parsed_at":"2024-10-27T19:22:59.266Z","dependency_job_id":"586da7e0-2358-4e85-b343-c649feb5b786","html_url":"https://github.com/arabacibahadir/sup-res","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arabacibahadir%2Fsup-res","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arabacibahadir%2Fsup-res/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arabacibahadir%2Fsup-res/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arabacibahadir%2Fsup-res/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/arabacibahadir","download_url":"https://codeload.github.com/arabacibahadir/sup-res/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244336125,"owners_count":20436772,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["algotrade","analysis","binance","binance-api","bitcoin","cryptocurrency","data-science","finance","pandas","pinescript","python","stock","telegram","telegram-bot","tradingview"],"created_at":"2024-10-27T18:56:26.481Z","updated_at":"2025-03-19T01:30:51.587Z","avatar_url":"https://github.com/arabacibahadir.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Sup-Res :chart_with_upwards_trend:\n\n_For online demonstration_ -\u003e https://arabacibahadir.github.io/sup-res/ \n\nSup-Res is  mobile-ready, offline-storage compatible and a great companion for finding liquidity pools, support and resistance levels with a scalable chart.\n\n![ezgif com-gif-maker](https://user-images.githubusercontent.com/32988819/166165397-af4c7f29-1746-49b6-be3a-9a12d838f7e6.gif)\n\n\n## Features :star2:\n\n- Easily find support-resistance and liquidity levels on the chart\n- Using it in almost any time series with sensitivity adjustment \n- Export documents as `HTML, PDF, .jpeg, .png` \n- Automatically share to your twitter followers with an image and text of support-resistance levels\n- Supports [Tradingview Pine Script](https://www.tradingview.com/pine-script-docs/en/v4/Introduction.html) \n- Manageable via [Telegram](https://python-telegram-bot.org)\n- WebUI\n\n![git](https://user-images.githubusercontent.com/32988819/148457547-45d47bc2-52a0-426a-8d4c-861fe6fd013d.png)\n\n## Installation :hammer_and_wrench:\nSup-Res requires Python 3.10+ to run.\nUse the package manager [pip](https://pip.pypa.io/en/stable/) to install libraries. This process may take a long time.\n\n```bash\npip install -r requirements.txt\n```\n\n## Usage :computer:\nThis tool allows you to generate charts for different cryptocurrencies and time frames using the Binance API.\nWhen you run the code, main function will ask ticker and time frame and then the local web page will open where you can see the support-resistance levels, RSI, SMA, MACD, Fibonacci and candlestick patterns. \n\nYou can run the script with arguments for the ticker and time frame you want to generate a chart for. To do this, enter the following command:\n````python\npython main.py \u003cticker\u003e \u003ctimeframe\u003e\n````\nFor example, to generate a chart for the BTCUSDT ticker with a 1-hour time frame, you would enter:\n````python\npython main.py BTCUSDT 1H\n````\nYou can also run the script without any arguments and then enter the ticker and time frame in the command line when prompted. To do this, enter the following command:\n\n````python\npython main.py \n````\nIf you want to generate charts for multiple pairs at once, you can use the `multiple_run.py` script located in the miniscripts directory. This script will generate charts for all the pairs listed in the `coin_list.csv` file. To run this script, enter the following command:\n````python\npython miniscripts/multiple_run.py\n````\n\n````\nSupported Tickers: \nAll Binance tickers\nSupported Time Frames: \n1M, 3M, 5M, 15M, 30M, 1H, 2H, 4H, 6H, 8H, 12H, 1D, 3D, 1W (M: Minute, H: Hour, D: Day, W: Week)\n````\n\nIf you want to share as a tweet, change api keys with yours in `git_tw_access.py` file, and change your user handle name. [Twitter API guide](https://developer.twitter.com/en/docs/twitter-api). Then uncomment `save` and `twitter` functions in `main.py`.\n\n````python\n# Twitter api keys -\u003e https://developer.twitter.com/en/docs/twitter-api\ntwitter_api = 'YOUR-API'\ntwitter_key_secret = 'API-SECRET'\ntwitter_token = 'TOKEN'\ntwitter_token_secret = 'TOKEN-SECRET'\nuser_handle = '@HANDLE-NAME'\n````\n\nPine Script file will be created after run successfully main function. \n\nYour python alias might be different like \"py, python3\", you should change your alias if you are using telegram-bot if your python alias is different. \n\n\u003eBy adjusting the sensitivity of the data in the code, you can obtain lines that are more precise.\n\n\n![chart](https://user-images.githubusercontent.com/32988819/166165460-b1e2be3e-014c-4aea-83e6-c118075f68df.png)\n\n\n \n## Main Motivation :books:\nThose who are new to investing do so without any technical expertise. Additionally, individuals who have limited experience make their buys and sells in accordance with various charts and follow the price actions. The main focus of this work is technical analysis.\n\nI worked on a piece of code that could be useful for users with little prior knowledge of price action. Don't invest if you really have no idea what you're doing. You should keep an eye on market trends before investing and try not to feel **FOMO**.\n\nZones rather than just lines typically represent supports and resistances. Markets push you toward points where you can stop your position, particularly in cryptocurrencies. Keep an eye out for breakouts with high volume, sudden price changes, and trend reversals. It is extremely risky to trade on new coin charts without support and resistance levels if you are investing in low volume coins.\n\n\n![image](https://user-images.githubusercontent.com/32988819/166165539-5a4eea0a-456e-482d-aa56-96b5eaffc37a.png)\n\n\n## Support-Resistance Lines :chart_with_downwards_trend:\n\nYou can draw a trustworthy line at a point where a pair has repeatedly failed to break it or has advanced by tapping it. The consensus is that this price should be touched at least twice and ideally three times. Reliability rises as the number of touches increases. If the price moves below the support line, this support will act as resistance. The opposite is also true. If the price breaks the resistance, it can work as support, but these situations should be fully supported by volume.\n\n![28sep](https://user-images.githubusercontent.com/32988819/135044659-579b26c8-8141-41c2-9b4e-d3c99b41b571.png)\n\n\n_28 September 2021 BTCUSDT Binance_\n\n## Indicators :bar_chart:\n[MA](https://www.investopedia.com/terms/m/movingaverage.asp), \n[RSI](https://www.investopedia.com/terms/r/rsi.asp), \n[MACD](https://www.investopedia.com/terms/m/macd.asp),\n[Fibonacci Retracement Levels](https://www.investopedia.com/terms/f/fibonacciretracement.asp),\n[Candlestick Patterns](https://www.elearnmarkets.com/blog/30-candlestick-charts-in-stock-market/)\n\nNever rely solely on a single piece of information or indicator as this can be deceptive. Fundamental analysis should always be combined with technical analysis.\n\n![legend](https://user-images.githubusercontent.com/32988819/168901021-81d885d4-19de-4ba6-a3d0-c69faf2ccbf5.png)\n\n## Pine Script :bookmark_tabs:\n\nSup-Res supports Pine Script scripting language. Just **run** *main.py* file, then **copy** \"./pinescript.txt\" and **paste** *Tradingview Pine Script* section.\nAlso telegram bot works with Pine Script.\n\nHere is the example Pine Script code:\n````\n//@version=5\nindicator('Sup-Res BTCUSDT 1d', overlay=true)\nplot(ta.sma(close, 50), title='50 SMA', color=color.new(color.blue, 0), linewidth=1)\nplot(ta.sma(close, 100), title='100 SMA', color=color.new(color.purple, 0), linewidth=1)\nplot(ta.sma(close, 200), title='200 SMA', color=color.new(color.red, 0), linewidth=1)\nhline(18626.0, title=\"Lines\", color=color.red, linestyle=hline.style_solid, linewidth=1)\nhline(18910.94, title=\"Lines\", color=color.red, linestyle=hline.style_solid, linewidth=1)\nhline(19706.66, title=\"Lines\", color=color.red, linestyle=hline.style_solid, linewidth=1)\nhline(20111.62, title=\"Lines\", color=color.red, linestyle=hline.style_solid, linewidth=1)\nhline(21888.0, title=\"Lines\", color=color.red, linestyle=hline.style_solid, linewidth=1)\nhline(22799.0, title=\"Lines\", color=color.red, linestyle=hline.style_solid, linewidth=1)\nhline(24668.0, title=\"Lines\", color=color.red, linestyle=hline.style_solid, linewidth=1)\n````\n\n## Contributing :handshake:\nPull requests are welcome, any contributions you make are greatly appreciated. Please open an issue with what you want changed before submitting a PR.\n\nFollow [PEP 8 Coding Style guidelines](https://www.python.org/dev/peps/pep-0008/).\n\n- Fork the Project\n- Create your Feature Branch `git checkout -b feature/NewFeature`\n- Commit your Changes `git commit -m 'Add some NewFeature'`\n- Push to the Branch `git push origin feature/NewFeature`\n- Open a Pull Request\n\n\n## License :page_with_curl:\nSup-Res is licensed under the GNU General Public License v3.0\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Farabacibahadir%2Fsup-res","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Farabacibahadir%2Fsup-res","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Farabacibahadir%2Fsup-res/lists"}