Skip to content

sarimk80/psx_sockets

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

26 Commits
 
 
 
 
 
 

Repository files navigation

📈 PSX iOS App

An iOS application for tracking the Pakistan Stock Exchange (PSX) in real time.
Built on top of psx-terminal for API and WebSocket integration.


✨ Features

  • Real-Time Ticker Updates – Stay up to date with live stock prices.
  • Company Fundamentals & Dividend History – Access detailed company data and past dividends.
  • Interactive Real-Time Graphs – Visualize market movements instantly.
  • Portfolio Tracking – Manage and monitor your personal holdings.
  • Clean, Modern UI – Optimized for speed and usability on iOS devices.

📽️ Demo Video

Simulator.Screen.Recording.-.iPhone.16.Pro.-.2025-09-23.at.15.33.20.mp4

📱 Screenshots


🚀 Getting Started

Prerequisites

  • macOS with Xcode installed
  • iOS 13.0+ device or simulator
  • Swift Package Manager (comes with Xcode)
  • Internet connection

Installation

  1. Clone the repository:

    git clone https://github.com/sarimk80/psx_sockets.git
    cd psx_sockets
  2. Open the project in Xcode:

    open PSX.xcodeproj
  3. Install dependencies:

    • All dependencies are managed via Swift Package Manager. Xcode should automatically fetch them when you open the project.
  4. Build and Run:

    • Select your target device or simulator in Xcode.
    • Press Run (▶️) to launch the app.

📦 Usage

  • Launch the app to view real-time stock information from the Pakistan Stock Exchange.
  • Add companies to your portfolio for quick access and monitoring.
  • Tap on tickers for detailed charts and company fundamentals.

🧩 Technology Stack

  • Swift, SwiftUI – iOS development
  • WebSocket, REST API – Real-time & historical data from psx-terminal
  • Combine – Reactive programming
  • Core Data – Local portfolio management

🤝 Contributing

Contributions, issues and feature requests are welcome!

  1. Fork the repository.
  2. Create a new branch (git checkout -b feature/my-feature).
  3. Commit your changes (git commit -am 'Add new feature').
  4. Push to the branch (git push origin feature/my-feature).
  5. Open a Pull Request.

Please read our contributing guidelines for details on our code of conduct, and the process for submitting pull requests.


📑 License

This project is licensed under the MIT License – see the LICENSE file for details.


🙋‍♂️ Author & Contact

Created by @sarimk80.
For questions or feedback, open an issue or reach out via LinkedIn or email.


⭐️ Acknowledgements

  • mumtazkahn/psx-terminal for backend data and WebSocket API.
  • Pakistan Stock Exchange for making market data available.

About

Psx investing app

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages