{"id":32898094,"url":"https://github.com/project54321/stocksniper","last_synced_at":"2026-04-11T07:37:47.542Z","repository":{"id":323298154,"uuid":"1092728807","full_name":"project54321/StockSniper","owner":"project54321","description":"\"An interactive Stock Dashboard that visualizes historical prices, calculates key financial metrics, displays fundamental statements, and aggregates the latest news for any ticker — all in a sleek, easy-to-use Streamlit interface.\"","archived":false,"fork":false,"pushed_at":"2025-11-09T10:09:21.000Z","size":20,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-11-09T11:28:51.883Z","etag":null,"topics":["alphavantage","finance","numpy","pandas","plotly","pypi","python","stock-market","stocknews","streamlit"],"latest_commit_sha":null,"homepage":"https://stocksniper1.streamlit.app/","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/project54321.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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-11-09T07:22:58.000Z","updated_at":"2025-11-09T10:11:50.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/project54321/StockSniper","commit_stats":null,"previous_names":["project54321/stocksniper"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/project54321/StockSniper","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/project54321%2FStockSniper","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/project54321%2FStockSniper/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/project54321%2FStockSniper/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/project54321%2FStockSniper/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/project54321","download_url":"https://codeload.github.com/project54321/StockSniper/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/project54321%2FStockSniper/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":283674810,"owners_count":26875274,"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","status":"online","status_checked_at":"2025-11-10T02:00:06.292Z","response_time":53,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["alphavantage","finance","numpy","pandas","plotly","pypi","python","stock-market","stocknews","streamlit"],"created_at":"2025-11-10T12:00:59.278Z","updated_at":"2025-11-10T12:01:55.345Z","avatar_url":"https://github.com/project54321.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 📊 Stock Dashboard https://stocksniper1.streamlit.app/\n\nA sleek, interactive dashboard to track stock prices, analyze key financial metrics, and stay updated on the latest news for any publicly traded company. Built with **Streamlit**, **yfinance**, **Alpha Vantage**, **Plotly**, and **StockNews API**, this dashboard provides investors, students, and finance enthusiasts with a modern and visually appealing interface for financial analysis.\n\n---\n\n## Features\n\n### 1. Stock Price Data\n- Pulls historical stock data using [Yahoo Finance](https://pypi.org/project/yfinance/).  \n- Displays a **line chart** of closing prices over a selected date range.  \n- Shows **raw data** in a scrollable table with row and column counts.  \n- Automatically detects the **Close price column** for plotting.\n\n### 2. Price Metrics\n- Calculates key metrics including:\n  - **Annual Return (%)**\n  - **Volatility (Standard Deviation)**\n  - **Risk-Adjusted Return** (Sharpe ratio-like metric)\n- Metrics are presented with **`st.metric` cards** for easy readability.  \n- Historical price data is available in an **expandable table** for detailed review.\n\n### 3. Fundamental Financial Data\n- Pulls **annual balance sheets, income statements, and cash flow statements** using the [Alpha Vantage API](https://www.alphavantage.co/).  \n- Financial statements are neatly organized and displayed inside **expanders** for a clean, uncluttered layout.  \n- Allows users to **analyze company fundamentals** at a glance.\n\n### 4. News Feed\n- Fetches **top 10 news articles** about the selected company using [StockNews API](https://pypi.org/project/stocknews/).  \n- Displays **publish date, title, summary**, and **sentiment analysis** (title \u0026 summary).  \n- Each article is presented in a **collapsible expander** to reduce visual clutter.\n\n### 5. Modern Layout\n- Inputs (ticker and date range) are displayed in a **top bar with columns**, not a sidebar, for a sleek interface.  \n- Metrics, charts, tables, and news are **responsive** and visually distinct.  \n- Footer with **credit and GitHub link** added for professional touch.\n\n---\n\n## Demo\n\nhttps://stocksniper1.streamlit.app/\n\n---\n\n## Installation\n\n### 1. Clone the repository\n```bash\ngit clone https://github.com/project54321/StockDashboard.git\ncd StockDashboard\n```\n\n2. Create a virtual environment (optional but recommended)\n```bash\nCopy code\npython -m venv venv\nsource venv/bin/activate  # Linux / macOS\nvenv\\Scripts\\activate     # Windows\n```\n\n4. Install dependencies\n```bash\nCopy code\npip install -r requirements.txt\n```\n\nrequirements.txt example:\n```nginx\nCopy code\nstreamlit\nyfinance\npandas\nnumpy\nplotly\npython-dotenv\nalpha_vantage\nstocknews\n```\n\n4. Add your API Key\nCreate a .env file in the project root:\n\n```env\nCopy code\nAPI_KEY=YOUR_ALPHA_VANTAGE_API_KEY\n```\n\nImportant: Keep .env in .gitignore to avoid committing your key.\n\nUsage\nRun the Streamlit app: streamlit run [pythonfile.py]\n\nEnter a ticker symbol (e.g., AAPL, MSFT).\n\nSelect start and end dates.\n\nNavigate between the Pricing Data, Fundamental Data, and Top 10 News tabs.\n\nExpand sections to view detailed data or news articles.\n\nEnvironment Variables\nAPI_KEY: Required for accessing Alpha Vantage data.\n\nLoaded using python-dotenv for security.\n\nProject Structure\n```bash\nCopy code\nStockDashboard/\n│\n├── app.py             # Main Streamlit application\n├── requirements.txt   # Python dependencies\n├── .env               # API keys (not committed)\n├── README.md          # Project documentation\n└── assets/            # Optional folder for screenshots, logos, etc.\n```\n\nTechnologies Used\nPython – Core programming language.\nStreamlit – Interactive dashboard framework.\nPlotly – Interactive charts and visualizations.\npandas / numpy – Data manipulation and calculations.\nyfinance – Historical stock prices.\nAlpha Vantage – Fundamental financial statements.\nStockNews – Company news feed and sentiment analysis.\n\nContributing\nContributions are welcome! To contribute:\n\nFork the repository.\n\nCreate a new branch for your feature/bugfix.\n\nSubmit a pull request with a detailed description of your changes.\n\nLicense\nMIT License\n\nCredits\nMade by Arjun Averineni | GitHub\n\nChanges in upcoming versions:\n- Authentication\n- Favicons\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fproject54321%2Fstocksniper","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fproject54321%2Fstocksniper","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fproject54321%2Fstocksniper/lists"}