{"id":15337279,"url":"https://github.com/vy/btcturktracker","last_synced_at":"2025-02-26T19:31:02.060Z","repository":{"id":15141351,"uuid":"17868689","full_name":"vy/BTCTurkTracker","owner":"vy","description":"BTCTurk data collector.","archived":false,"fork":false,"pushed_at":"2014-03-18T14:27:39.000Z","size":128,"stargazers_count":1,"open_issues_count":0,"forks_count":1,"subscribers_count":3,"default_branch":"master","last_synced_at":"2024-10-03T13:21:07.250Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Scala","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/vy.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}},"created_at":"2014-03-18T14:25:47.000Z","updated_at":"2015-05-15T11:35:51.000Z","dependencies_parsed_at":"2022-08-29T01:30:23.758Z","dependency_job_id":null,"html_url":"https://github.com/vy/BTCTurkTracker","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/vy%2FBTCTurkTracker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vy%2FBTCTurkTracker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vy%2FBTCTurkTracker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vy%2FBTCTurkTracker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/vy","download_url":"https://codeload.github.com/vy/BTCTurkTracker/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":219842568,"owners_count":16556532,"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":[],"created_at":"2024-10-01T10:20:24.227Z","updated_at":"2024-10-15T23:22:00.636Z","avatar_url":"https://github.com/vy.png","language":"Scala","funding_links":[],"categories":[],"sub_categories":[],"readme":"[BTCTurkTracker](http://github.com/vy/BTCTurkTracker) is a Scala application\nthat periodically collects data from [BTCTurk](http://btcturk.com)\n[API](https://btcturk.com/yardim/api-home-page).\n\nUsage\n-----\n\nYou can build a JAR out of Scala sources using `sbt`:\n\n    $ git clone http://github.com/vy/BTCTurkTracker.git\n    $ cd BTCTurkTracker\n    $ sbt assembly\n\n`assembly` task creates a `BTCTurkTracker-assembly-\u003cVERSION\u003e.jar` under\n`target/scala-\u003cVERSION\u003e` directory. You can use this jar as follows.\n\n    $ java -jar target/scala-2.10/BTCTurkTracker-assembly-0.1.jar -h\n      Usage: \u003cmain class\u003e [options]\n        Options:\n          -h, --help\n\n             Default: false\n        * -o, --outputDir\n             Data storage directory.\n          -p, --updatePeriod\n             Data update period (in seconds)\n             Default: 3\n\nNote that [BTCTurk API](https://btcturk.com/yardim/api-home-page) allows\nat most 1 request per second. `BTCTurkTracker` performs 3 requests in\nsequential order: `ticker`, `orderbook`, and `trades`. In order to not\nexceed the maximum request threshold, `updatePeriod` parameter must be\nlarger than or equal to `3`.\n\n    $ java -jar target/scala-2.10/BTCTurkTracker-assembly-0.1.jar -o /tmp/btc -p 3\n\nAlternatively, you can start `BTCTurkTracker` using the shell script\nprovided under `bin` directory.\n\n    $ bin/BTCTurkTracker.sh\n    Usage: bin/BTCTurkTracker.sh \u003cBTCTurkTracker.jar\u003e \u003coutputDirectory\u003e [\u003cupdatePeriod\u003e]\n\nShell script contains some extra JVM flags for optimization.\n\nOutput\n------\n\nWhen you start `BTCTurkTracker`, it starts to periodically collect data\nto the specified directory. The contents of the `outputDirectory` is as\nfollows:\n\n    /last_trade_id.txt\n    /2014/03/17/order-book.tab\n    /2014/03/17/ticker.tab\n    /2014/03/17/trades.tab\n    /2014/03/18/order-book.tab\n    /2014/03/18/ticker.tab\n    /2014/03/18/trades.tab\n    ...\n\nEach file contains the tabulated raw data collected through the corresponding\nAPI call. Formats of the generated files are as follows.\n\n`last_trade_id.txt` contains the last received trade id from the `trades`\nAPI call. A sample content of the file is presented below.\n\n    $ cat /tmp/btc/last_trade_id.txt\n    5327149b3ab4750c7c4c3d73\n\n`ticker.tab` contains the list of `ticker` API call responses. Each line\ncontains the following TAB separated fields:\n\n- `\u003ctimestamp\u003e`\n- `\u003clow\u003e`\n- `\u003chigh\u003e`\n- `\u003clast\u003e`\n- `\u003cbid\u003e`\n- `\u003cask\u003e`\n- `\u003cvolume\u003e`\n\nA sample snippet of `ticker.tab` is as follows.\n\n    $ head -n 1 /tmp/btc/2014/03/17/ticker.tab\n    1395070197.0    1373.47    1406.11    1387.10    1384.00    1387.10    48.15\n\n`order-book.tab` contains the list of `orderbook` API call responses. Each\nline contains the following TAB separated fields:\n\n- `\u003ctimestamp\u003e`\n- `\u003cbid_0_price\u003e:\u003cbid_0_amount\u003e,\u003cbid_1_price\u003e:\u003cbid_1_amount\u003e,...`\n- `\u003cask_0_price\u003e:\u003cask_0_amount\u003e,\u003cask_1_price\u003e:\u003cask_1_amount\u003e,...`\n\nA sample snippet of `order-book.tab` is as follows.\n\n    $ head -n 1 /tmp/btc/2014/03/17/order-book.tab\n    1395070282.0    1384.00:0.72632458,1382.01:0.00126072,...    1798.01:2.29470410,1799.00:0.72592064,...\n\n`trades.tab` lists the `trades` API call responses. Each line contains a\nTAB separated list of trades, where each trade is represented as follows:\n`\u003ctimestamp\u003e,\u003ctid\u003e,\u003cprice\u003e,\u003camount\u003e`.\n\nLicense\n-------\n\nThe [BTCTurkTracker](https://github.com/vy/BTCTurkTracker/) by\n[Volkan Yazıcı](http://vlkan.com/) is licensed under the\n[Creative Commons Attribution 4.0 International License](http://creativecommons.org/licenses/by/4.0/).\n\n[![Creative Commons Attribution 4.0 International License](http://i.creativecommons.org/l/by/4.0/80x15.png)](http://creativecommons.org/licenses/by/4.0/)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvy%2Fbtcturktracker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvy%2Fbtcturktracker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvy%2Fbtcturktracker/lists"}