{"id":17290789,"url":"https://github.com/timothycarambat/senate-stock-watcher-data","last_synced_at":"2025-10-31T13:29:18.239Z","repository":{"id":135662954,"uuid":"256883853","full_name":"timothycarambat/senate-stock-watcher-data","owner":"timothycarambat","description":"Data repository of JSON files that are filed by US Senators on efdsearch.senate.gov where they must report their stock trades. This is the same data as on senatestockwatcher.com","archived":false,"fork":false,"pushed_at":"2021-03-16T18:13:58.000Z","size":6404,"stargazers_count":62,"open_issues_count":3,"forks_count":8,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-03-28T00:41:48.258Z","etag":null,"topics":["insider-trading","investing","investment-analysis","open-datasets","senate","senators","stock","stock-market-data","united-states","us-data"],"latest_commit_sha":null,"homepage":"https://senatestockwatcher.com/","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/timothycarambat.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}},"created_at":"2020-04-19T00:49:07.000Z","updated_at":"2025-03-18T05:26:47.000Z","dependencies_parsed_at":null,"dependency_job_id":"e96d8317-32d7-47b5-9ee8-142744111234","html_url":"https://github.com/timothycarambat/senate-stock-watcher-data","commit_stats":{"total_commits":12,"total_committers":1,"mean_commits":12.0,"dds":0.0,"last_synced_commit":"384e08e84d809477cdfba7d52479147fbe5e6bd7"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/timothycarambat%2Fsenate-stock-watcher-data","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/timothycarambat%2Fsenate-stock-watcher-data/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/timothycarambat%2Fsenate-stock-watcher-data/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/timothycarambat%2Fsenate-stock-watcher-data/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/timothycarambat","download_url":"https://codeload.github.com/timothycarambat/senate-stock-watcher-data/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248869896,"owners_count":21174948,"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":["insider-trading","investing","investment-analysis","open-datasets","senate","senators","stock","stock-market-data","united-states","us-data"],"created_at":"2024-10-15T10:39:08.231Z","updated_at":"2025-10-31T13:29:18.208Z","avatar_url":"https://github.com/timothycarambat.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Senate Stock Watcher - Data Storage\n![https://senatestockwatcher.com](https://senatestockwatcher.com/assets/img/logo--dark.svg)\n\n### What is this?\n[Senate Stock Watcher](https://senatestockwatcher.com) is a web application that shows metrics and analytics for tickers, senators, and filings that are reported by US Senators, both current and present.\n\nThe data that is collected is originally sourced from [The Ethical Financial Disclosure Office](https://efdsearch.senate.gov/search/home/) of the US Senate. We retain this data in a much more readable and concise format.\n\nAll files are available as `YAML` as well.\n`data/transaction_report_for_MM_DD_YYY.json` =\u003e `data/transaction_report_for_MM_DD_YYY.json.yaml`\n\nAll files with the exception of the following have the `bioguide` id available:\n- `aggregate/all_ticker_transactions.*`\n- `aggregate/all_transactions.*`\n\n\n### Structure\n**data/** - Contains the daily summaries as they are reported with a file naming convention of `transaction_report_for_MM_DD_YYY.json`. The structure is as follows:\n```\n[\n//list of objects. Each object is a senator who filed that day - they can appear more than once if they filed twice that day.\n  {\n    \"first_name\": \"John D\",\n    \"last_name\": \"Fremont\",\n    \"office\": \"Fremont, John D. (Senator)\",\n    \"ptr_link\": \"https://efdsearch.senate.gov/search/view/ptr/xxx-xxxx-xxxxxxxx-xxxx/\",\n    \"date_recieved\": \"01/03/2019\",\n    \"transactions\": [ // array of objects. each object is a transaction (or trade)\n      {\n        \"transaction_date\": \"12/16/2016\",\n        \"owner\": \"Spouse\",\n        \"ticker\": \"--\", // -- means the ticker is unknown. Otherwise is NASDAQ ticker\n        \"asset_description\": \"Sample Sam Corp\",\n        \"asset_type\": \"Stock\",\n        \"type\": \"Purchase\",\n        \"amount\": \"$1,001 - $15,000\", // dollar range reported\n        \"comment\": \"I bought this stock because I liked the name!\"\n      }, {...}]},\n      {...}, //next senator\n      {...} //last senator\n```\n\n**aggregate/** - Files that are the above data but pre-compiled into more concise formats. Data available is\n`all_transactions.json` - Merged JSON of all transactions done to date. Includes senator name in transaction with PTR link.\n`all_daily_summaries.json` - Merged JSON of all the daily summaries.\n`all_ticker_transactions.json` - All transactions grouped by their ticker. All '--' tickers are together.\n`all_transactions_for_senators.json` - All Transactions grouped by the senator who executed them.\n\n\n### Comments:\nThis repo will be updated on continually as more reports are filed. Senators that scan in their PDF will show as a trader for that day but have `transactions: []` in their record. These gaps are being backfilled and automatically updated in collaboration with [https://github.com/jeremiak/us-senate-financial-disclosure-data/](https://github.com/jeremiak/us-senate-financial-disclosure-data/)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftimothycarambat%2Fsenate-stock-watcher-data","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftimothycarambat%2Fsenate-stock-watcher-data","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftimothycarambat%2Fsenate-stock-watcher-data/lists"}