Skip to content

sarimk80/psx_sockets

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

30 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