{"id":13697967,"url":"https://github.com/yasinkuyu/binance-trader","last_synced_at":"2025-05-14T22:07:40.920Z","repository":{"id":37677482,"uuid":"106051375","full_name":"yasinkuyu/binance-trader","owner":"yasinkuyu","description":"💰 Cryptocurrency Trading Bot for Binance (Experimental)","archived":false,"fork":false,"pushed_at":"2024-05-01T21:05:45.000Z","size":3999,"stargazers_count":2611,"open_issues_count":95,"forks_count":836,"subscribers_count":251,"default_branch":"master","last_synced_at":"2025-04-13T18:44:35.341Z","etag":null,"topics":["arbitrage","binance","bitcoin","btc","cryptocurrency","trade"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/yasinkuyu.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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":"2017-10-06T21:22:47.000Z","updated_at":"2025-04-12T04:11:45.000Z","dependencies_parsed_at":"2024-09-24T04:00:38.704Z","dependency_job_id":"4b5bfdc1-c4fa-40e4-bd1f-1b506ed1b02b","html_url":"https://github.com/yasinkuyu/binance-trader","commit_stats":{"total_commits":113,"total_committers":17,"mean_commits":6.647058823529412,"dds":0.2831858407079646,"last_synced_commit":"80e6a05a40ec3b69844d720e2bc25f8d705dba05"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yasinkuyu%2Fbinance-trader","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yasinkuyu%2Fbinance-trader/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yasinkuyu%2Fbinance-trader/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yasinkuyu%2Fbinance-trader/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/yasinkuyu","download_url":"https://codeload.github.com/yasinkuyu/binance-trader/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254235696,"owners_count":22036963,"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":["arbitrage","binance","bitcoin","btc","cryptocurrency","trade"],"created_at":"2024-08-02T18:01:07.418Z","updated_at":"2025-05-14T22:07:35.879Z","avatar_url":"https://github.com/yasinkuyu.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":[],"readme":"# Binance Trader (RC 2)\n\nThis is an experimental bot for auto trading the binance.com exchange. [@yasinkuyu](https://twitter.com/yasinkuyu)\n\n![Screenshot](https://github.com/yasinkuyu/binance-trader/blob/master/img/screenshot.png)\n\n## Configuration\n\n1. [Signup](https://www.binance.com/?ref=10701111) for Binance\n2. Enable Two-factor Authentication\n3. Go API Center, [Create New](https://www.binance.com/en/my/settings/api-management?ref=10701111) Api Key\n\n        [✓] Read Info [✓] Enable Trading [X] Enable Withdrawals\n\n4. Rename **config.sample.py** to `config.py` / **orders.sample.db** to `orders.db`\n5. Get an API and Secret Key, insert into `config.py`\n\n        API key for account access\n        api_key = ''\n        Secret key for account access\n        api_secret = ''\n\n        [API Docs](https://www.binance.com/restapipub.html)\n\n6. Optional: Modify recv_window value (not recommended)\n\n7. Optional: run as an excutable application in Docker containers\n\n## Support\n\n[https://www.binance.com/?ref=10701111](https://www.binance.com/?ref=10701111)\n\n## Requirements\n\n    sudo pip install requests\n\n    Python 3\n        import os\n        import sys\n        import time\n        import config\n        import argparse\n        import threading\n        import sqlite3\n\n## Usage (trading module)\n\n    python trader.py --symbol XVGBTC\n\n    Example parameters\n\n    # Profit mode (default)\n    python trader.py --symbol XVGBTC --quantity 300 --profit 1.3\n    or by amount\n    python trader.py --symbol XVGBTC --amount 0.0022 --profit 3\n\n    # Range mode\n    python trader.py --symbol XVGBTC --mode range --quantity 300 --buyprice 0.00000780 --sellprice 0.00000790\n    or by amount\n    python trader.py --symbol XVGBTC --mode range --amount 0.0022 --buyprice 0.00000780 --sellprice 0.00000790\n\n    --quantity     Buy/Sell Quantity (default 0) (If zero, auto calc)\n    --amount       Buy/Sell BTC Amount (default 0)\n    --symbol       Market Symbol (default XVGBTC or XVGETH)\n    --profit       Target Profit Percentage (default 1.3)\n    --stop_loss    Decrease sell price at loss Percentage (default 0)\n    --orderid      Target Order Id (default 0)\n    --wait_time    Wait Time (seconds) (default 0.7)\n    --increasing   Buy Price Increasing  +(default 0.00000001)\n    --decreasing   Sell Price Decreasing -(default 0.00000001)\n    --prints       Scanning Profit Screen Print (default True)\n    --loop         Loop (default 0 unlimited)\n\n    --mode         Working modes profit or range (default profit)\n                   profit: Profit Hunter. Find defined profit, buy and sell. (Ex: 1.3% profit)\n                   range: Between target two price, buy and sell. (Ex: \u003c= 0.00000780 buy - \u003e= 0.00000790 sell )\n\n    --buyprice     Buy price (Ex: 0.00000780)\n    --sellprice    Buy price (Ex: 0.00000790)\n\n    Symbol structure;\n        XXXBTC  (Bitcoin)\n        XXXETH  (Ethereum)\n        XXXBNB  (Binance Coin)\n        XXXUSDT (Tether)\n\n    All binance symbols are supported.\n\n    Every coin can be different in --profit and --quantity.\n    If quantity is empty --quantity is automatically calculated to the minimum qty.\n\n    Variations;\n        trader.py --symbol TBNBTC --quantity 50 --profit 3\n        trader.py --symbol NEOBTC --amount 0.1 --profit 1.1\n        trader.py --symbol ETHUSDT --quantity 0.3 --profit 1.5\n        ...\n\n## Usage (balances module)\n\n    python balance.py\n\n## Run in a Docker container\n\n    docker build -t trader .\n\n    docker run trader\n\n## DISCLAIMER\n\n    I am not responsible for anything done with this bot.\n    You use it at your own risk.\n    There are no warranties or guarantees expressed or implied.\n    You assume all responsibility and liability.\n\n## Contributing\n\n    Fork this Repo\n    Commit your changes (git commit -m 'Add some feature')\n    Push to the changes (git push)\n    Create a new Pull Request\n\n    Thanks all for your contributions...\n\n    Contributors\n        @WeSpeakCrypto\n        @afoke\n        @omerfarukz\n        @plgonzalezrx8\n\n## Troubleshooting\n\n    Filter failure: MIN_NOTIONAL\n    https://support.binance.com/hc/en-us/articles/115000594711-Trading-Rule\n\n    Filter failure: PRICE_FILTER\n    https://github.com/binance-exchange/binance-official-api-docs/blob/master/rest-api.md\n\n    Timestamp for this request was 1000ms ahead of the server's time.\n    https://github.com/yasinkuyu/binance-trader/issues/63#issuecomment-355857901\n\n## Roadmap\n\n    - MACD indicator (buy/sell)\n    - Stop-Loss implementation\n    - Working modes\n      - profit: Find defined profit, buy and sell. (Ex: 1.3% profit)\n      - range:  Between target two price, buy and sell. (Ex: \u003c= 0.00100 buy - \u003e= 0.00150 sell )\n    - Binance/Bittrex/HitBTC Arbitrage  \n\n    ...\n\n    - October 7, 2017 Beta\n    - January 6, 2018 RC\n    - January 15, 2018 RC 1\n    - January 20, 2018 RC 2\n\n## License\n\nCode released under the [MIT License](https://opensource.org/licenses/MIT).\n\n---\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyasinkuyu%2Fbinance-trader","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fyasinkuyu%2Fbinance-trader","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyasinkuyu%2Fbinance-trader/lists"}