{"id":22544061,"url":"https://github.com/vanillaiice/vcryptobot","last_synced_at":"2026-03-19T23:05:36.070Z","repository":{"id":185909773,"uuid":"674306713","full_name":"vanillaiice/vcryptobot","owner":"vanillaiice","description":"Simple Crypto Trading Bot Using Binance Spot \u0026 Websocket API Written in V.","archived":false,"fork":false,"pushed_at":"2023-12-06T03:42:35.000Z","size":72,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-10-26T21:33:09.286Z","etag":null,"topics":["binance","binance-api","binance-api-trading","bot","crypto","trading-bot","v","vlang"],"latest_commit_sha":null,"homepage":"","language":"V","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/vanillaiice.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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2023-08-03T16:09:02.000Z","updated_at":"2024-02-27T03:38:19.000Z","dependencies_parsed_at":null,"dependency_job_id":"2c931338-9f59-434f-baa7-22c0ef62ca33","html_url":"https://github.com/vanillaiice/vcryptobot","commit_stats":null,"previous_names":["vanillaiice/v-crypto-bot"],"tags_count":8,"template":false,"template_full_name":null,"purl":"pkg:github/vanillaiice/vcryptobot","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vanillaiice%2Fvcryptobot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vanillaiice%2Fvcryptobot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vanillaiice%2Fvcryptobot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vanillaiice%2Fvcryptobot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/vanillaiice","download_url":"https://codeload.github.com/vanillaiice/vcryptobot/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vanillaiice%2Fvcryptobot/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29519436,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-16T18:37:19.720Z","status":"ssl_error","status_checked_at":"2026-02-16T18:36:46.920Z","response_time":115,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["binance","binance-api","binance-api-trading","bot","crypto","trading-bot","v","vlang"],"created_at":"2024-12-07T14:06:04.194Z","updated_at":"2026-02-16T21:33:40.278Z","avatar_url":"https://github.com/vanillaiice.png","language":"V","funding_links":[],"categories":[],"sub_categories":[],"readme":"# V Crypto Bot\n\nSimple Crypto Trading Bot using Binance Spot and Websocket API.\nThis Bot buys and sells crypto at user specified margins.\n\n## Usage\n\n```\nvcryptobot --config your_config.json\n```\n\n- Omitting the ```--config``` option will trigger the config file creation interactive prompt.\n- Also, you can create an .env file containing your binance api key and secret key in the following format:\n\n```\nSECRET_KEY = \"\u003cYOUR SECRET KEY\u003e\"\nAPI_KEY = \"\u003cYOUR API KEY\u003e\"\n```\n\n- If the .env file is not present, the .env file creation interactive prompt will be trigerred.\n- **Testnet** secret and api keys can be created [here](https://testnet.binance.vision)\n\n## Dependencies\n\n- [sqlite](https://modules.vlang.io/db.sqlite.html)\n- [zztkm.vdotenv](https://github.com/zztkm/vdotenv)\n- [vanillaiice.vbinance](https://github.com/vanillaiice/vbinance)\n- make (optional)\n- MinGW-w64 (optional, for windows cross compilation)\n\n## Additional tools\n\nTo view the data in the sqlite databases (prices and transaction receipts), you can install [DB Browser for sqlite](https://sqlitebrowser.org/dl/).\n\n## Installation\n\nFirst, make sure that you have [V](https://github.com/vlang/v/blob/master/README.md#installing-v-from-source) \nand [sqlite](https://modules.vlang.io/db.sqlite.html) (should already be installed for MacOS users) installed on your machine. Then, you can do the following:\n\n```\n\u003e git clone https://github.com/vanillaiice/vcryptobot\n\u003e cd vcryptobot\n\u003e v install\n\u003e v .\n// or\n\u003e make\n```\n\n## Config File\n\n- ```base```, base currency of the trading pair.\n\u003e example: \"BTC\"\n\n- ```quote```, quote currency of the trading pair.\n\u003e example: \"USDT\"\n\n- ```tradingBalance```, initial trading balance of the bot.\n\u003e example for BTC: 0.01\n\n- ```firstTx```, type of the first transaction executed by the bot.\n\u003e accepted values: \"buy\" or \"sell\"\n\n- ```skipFirstTx```, if the bot should skip the first transaction (firstTx).\n\u003e accepted values: true or false\n\n- ```percentChangeBuy```, percent change between the last sell price and current price, at which the bot will buy.\n\u003e example value (%): 5.0\n\n- ```percentChangeSell```, percent change between the current price and last buy price, at which the bot will sell.\n\u003e example value (%): 5.0\n\n- ```trailingStopLossMargin``` (optional, default 0), percent change between the current price and last buy price, at which the bot will sell to limit losses.\n\u003e example value (%): 2.5\n\n- ```stopEntryPrice``` (optional, default 0), entry price at which the bot will buy.\n\u003e example value for BTC: 0.011\n\n- ```stopEntryPriceMargin``` (optional, default 0), minimum percent change between the current price and the stop entry price, at which the bot will buy. \n\u003e example value (%): 0.1 \n\n- ```adjustTradingBalanceLoss```, if the bot should substract losses from the trading balance.\n\u003e accepted values: true or false\n\n- ```adjustTradingBalanceProfit```, if the bot should add profits to the trading balance.\n\u003e accepted values: true or false\n\n- ```stopAfterTx``` (optional, default 0), the number of transactions that the bot will execute.\n\u003e example: 5\n\n- ```decisionIntervalMs```, time in milliseconds at which the bot will decide to buy or sell.\n\u003e example value in ms: 1500\n\n- ```serverBaseEndpoint```, base endpoint of the Binance API server.\n\u003e example base endpoint for testnet server: \"testnet.binance.vision\"\n\n\u003e example base endpoint for normal server: \"api.binance.com\"\n\n- ```outputTarget```, output target of the content of the bot's log.\n\u003e accepted values: \"console\", \"file\", \"both\"\n\n- ```logLevel```, log level of the bot.\n\u003e accepted values: \"fatal\", \"error\", \"warn\", \"info\", \"debug\"\n\n- ```logPriceToDb```, if the bot should log the prices fetched in a sqlite database.\n\u003e accepted values: true or false\n\n- ```logTxToDb```, if the bot should log the transaction receipts in a sqlite database.\n\u003e accepted values: true or false\n\n## Acknowledgments\n\n- [zztkm.vdotenv](https://github.com/zztkm/vdotenv), MIT License\n\n## Disclaimer\n\n- No warranty whatsoever, use at your own risk\n- Trading crypto is very risky, *only invest in what you can afford to lose*\n\n## Author\n\nVanillaiice\n\n## Licence\n\nBSD-3-Clause\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvanillaiice%2Fvcryptobot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvanillaiice%2Fvcryptobot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvanillaiice%2Fvcryptobot/lists"}