{"id":21887360,"url":"https://github.com/sskender/bitcoin-alert","last_synced_at":"2026-04-02T04:47:47.960Z","repository":{"id":79364830,"uuid":"145133131","full_name":"sskender/bitcoin-alert","owner":"sskender","description":"Bitcoin alert in Express","archived":false,"fork":false,"pushed_at":"2019-03-13T23:13:43.000Z","size":38,"stargazers_count":0,"open_issues_count":0,"forks_count":1,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-01-26T20:26:10.378Z","etag":null,"topics":["bitcoin","crypto","gilfoyle","silicon-valley"],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","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/sskender.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":"2018-08-17T14:51:59.000Z","updated_at":"2019-03-13T23:13:44.000Z","dependencies_parsed_at":null,"dependency_job_id":"07cddf36-be17-4d24-bef2-f5d56cc84e2b","html_url":"https://github.com/sskender/bitcoin-alert","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/sskender%2Fbitcoin-alert","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sskender%2Fbitcoin-alert/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sskender%2Fbitcoin-alert/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sskender%2Fbitcoin-alert/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sskender","download_url":"https://codeload.github.com/sskender/bitcoin-alert/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244894944,"owners_count":20527800,"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":["bitcoin","crypto","gilfoyle","silicon-valley"],"created_at":"2024-11-28T11:09:27.469Z","updated_at":"2025-12-30T20:49:13.601Z","avatar_url":"https://github.com/sskender.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Bitcoin Alert\n\nBitcoin price alert written in Express JS.\n\n## About\n\n[Inspired by Gilfoyle (Silicon Valley).](https://www.youtube.com/watch?v=gz7IPTf1uts)\n\nDefine price level and when Bitcoin reaches it, alarm will let you know. Even though you may not have a mining rig at home that you need to remotely toggle, you would rather watch the paint dry than monitor exchanges all the time. If you want something simple, customizable, *LOUD* and efficient (fond of Gilfoyle also) you are in the right place. Otherwise, keep looking. Or just code your own notificator. I did.\n\n### Installing\n\nInstall dependencies:\n\n```\nnpm install\n```\n\nRun:\n\n```\nnpm start\n```\n\nRun development:\n\n```\nnpm run dev\n```\n\nOpen browser:\n\n```\nlocalhost:3000\n```\n\n### Prerequisites\n\nApplication settings are stored in [.env](.env) and [config.js](config/config.js) files. User data is saved in database.\n\nPlace your alarm sound in [notifications](notifications) folder. Make sure it's named \"alarm.mp3\". This is not required if alarm is silenced (see below how to do that). But what's the point then, right?\n\n### Usage\n\nAdd alert:\n\n```\n/add/\u003ccoin\u003e/\u003ctarget price\u003e\n```\n\nRemove alert:\n\n```\n/remove/\u003ccoin\u003e/\u003ctarget price\u003e\n```\n\nChange tolerance range:\n\n```\n/tolerance/\u003ccoin\u003e/\u003cprice range\u003e\n```\n\nExamples:\n\n```\n/add/btc/5670\n/add/btc/5100\n/add/eth/250\n```\n\n```\n/remove/btc/5670\n/remove/eth/250\n```\n\n```\n/tolerance/btc/25\n/tolerance/eth/10\n```\n\nClear all price targets for coin:\n\n```\n/clear/btc\n/clear/eth\n```\n\nShow target prices:\n\n```\n/target\n/target/\u003ccoin\u003e\n/targetid/\u003cmongodb-id\u003e\n```\n\nShow coin data like current price, volume, tolerance setting:\n\n```\n/coin\n/coin/\u003ccoin\u003e\n/coin/btc\n```\n\nTurn alarm off:\n\n```\n/off\n```\n\nTurn alarm back on:\n\n```\n/on\n```\n\nEvery API call will return status code and JSON object.\n\n## MongoDB interaction\n\nStart shell:\n\n```\nmongo\n```\n\nSelect database:\n\n```\nshow dbs\nuse bitcoin-alert\n````\n\nShow collections and data:\n\n```\nshow collections\ndb.pricetargets.find().pretty()\ndb.coins.find().pretty()\n\ndb.coins.deleteMany({coin: 'BTC'})\n```\n\n## Built With\n\n* [Express](https://expressjs.com/) - Node.js web application framework\n* [Cryptonator API](https://www.cryptonator.com/) - Cryptocurrencies exchange rates API\n* [MongoDB](https://www.mongodb.com/) - free and open-source cross-platform document-oriented database\n\n## License\n\nThis project is licensed under the GNU License - see the [LICENSE](LICENSE) file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsskender%2Fbitcoin-alert","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsskender%2Fbitcoin-alert","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsskender%2Fbitcoin-alert/lists"}