Real-time stock tracking for iOS, built with SwiftUI.
Features · Demo · Screenshots · Getting Started · Tech Stack · Contributing
| Feature | Description | |
|---|---|---|
| 📡 | Live Ticker | Real-time price updates streamed via WebSocket |
| 📊 | Interactive Charts | Visualize market movements with live, touch-friendly graphs |
| 🏢 | Company Fundamentals | Detailed financials, ratios, and full dividend history |
| 💼 | Portfolio Tracker | Add, track, and monitor your personal holdings |
| 🏦 | ETF Browser | Browse and explore Exchange Traded Funds listed on PSX |
| 🎨 | Modern UI | Clean, fast, and native iOS experience built in SwiftUI |
Simulator.Screen.Recording.-.iPhone.17.Pro.-.2026-02-03.at.10.47.25.mov
- macOS with Xcode 15+ installed
- iOS 13.0+ device or simulator
- Swift Package Manager (bundled with Xcode)
- Active internet connection
# 1. Clone the repository
git clone https://github.com/sarimk80/psx_sockets.git
cd psx_sockets
# 2. Open in Xcode
open PSX.xcodeproj- Xcode will automatically resolve Swift Package Manager dependencies on first launch.
- Select your target device or simulator, then press ▶ Run.
Note: The app connects to psx-terminal for live data. Ensure the backend is reachable before running.
- Launch the app to view real-time stock data from the Pakistan Stock Exchange.
- Search for any ticker to see its price, charts, and company fundamentals.
- Add to Portfolio to track your personal holdings and monitor performance.
- Browse ETFs by category with fund size, market cap, and holdings breakdown.
- Tap any chart to interact with historical price data across multiple timeframes.
| Layer | Technology |
|---|---|
| UI | SwiftUI |
| Language | Swift 5.9 |
| Real-Time Data | WebSocket |
| REST API | URLSession + Async/Await |
| Reactive | Combine |
| Local Storage | Core Data |
| Backend | psx-terminal |
Contributions, issues, and feature requests are welcome!
# 1. Fork the repo and create your branch
git checkout -b feature/your-feature
# 2. Commit your changes
git commit -am 'feat: add your feature'
# 3. Push and open a Pull Request
git push origin feature/your-featurePlease read CONTRIBUTING.md for our code of conduct and PR guidelines.
Distributed under the MIT License — see LICENSE for details.
Sarim Khan — @sarimk80
- mumtazkahn/psx-terminal — backend API and WebSocket data provider
- Pakistan Stock Exchange for making market data accessible
If this project is useful to you, consider giving it a ⭐ — it helps others find it!