{"id":18649822,"url":"https://github.com/ashwanthkumar/kite-history","last_synced_at":"2025-08-01T01:11:14.209Z","repository":{"id":140450569,"uuid":"375055912","full_name":"ashwanthkumar/kite-history","owner":"ashwanthkumar","description":"Script to build Personal Database of Historical Options Data from NIFTY, BANKNIFTY and FINNIFTY","archived":false,"fork":false,"pushed_at":"2021-06-09T11:37:52.000Z","size":22,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2024-12-27T12:44:50.351Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","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/ashwanthkumar.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":"2021-06-08T15:20:03.000Z","updated_at":"2023-08-19T08:16:16.000Z","dependencies_parsed_at":null,"dependency_job_id":"93110e84-6ba0-4e16-9c49-e68fb22b1ec0","html_url":"https://github.com/ashwanthkumar/kite-history","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/ashwanthkumar%2Fkite-history","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ashwanthkumar%2Fkite-history/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ashwanthkumar%2Fkite-history/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ashwanthkumar%2Fkite-history/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ashwanthkumar","download_url":"https://codeload.github.com/ashwanthkumar/kite-history/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":239456409,"owners_count":19641843,"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-11-07T06:40:46.176Z","updated_at":"2025-02-18T10:41:42.249Z","avatar_url":"https://github.com/ashwanthkumar.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# kite-history\n\nNodeJS script to download historical candle data from [kite.trade](https://kite.trade/docs/connect/v3/historical/) API. The idea is to build a local (personal) copy of all the data as CSV files which can later be consumed for analysis.\n\n## Usage\nWhen running for the first time\n```\n$ npm install\n```\n\nAuth token is generated as per the documentation at https://kite.trade/docs/connect/v3/user/.\n```\n$ KITE_AUTH=\"\u003cauthToken\u003e\" ./index.js --maxDays 1000\n```\n\nIdeally you can change the maxDays to a more real number like 30 for the seed run and then keep running it with just 7 to sync all the data locally. Make sure Kite API doesn't provide access to expired instruments (which are very common for Weekly Expires), so have that in mind when you're caching the data locally.\n\n## Goals\n- Ability to build a database of 1minute options data for 3 broad indices that are traded on Indian Market - NIFTY, BANKNIFTY and FINNIFTY.\n- We want to get both weekly and monthly expiry data.\n- Write the output in a CSV which is universally consumable for any kind of analysis that we would want to do in the future.\n\n## Notes\n1. We write a CSV file in a folder even if there isn't any data to write. We would write an empty CSV file with just headers. That is by design. We would like to know if a particular instrument is not being traded on a given day is good to know.\n2. The output is written in a `data/` folder in the current folder.\n3. These scripts in this folder are shared as is without any warranty. I'll probably not accept PRs unless things are broken. Please feel free to fork for any custom modifications.\n\n## License\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fashwanthkumar%2Fkite-history","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fashwanthkumar%2Fkite-history","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fashwanthkumar%2Fkite-history/lists"}