phisix

Java CI with Maven Codacy Badge Codacy Badge Mergify Status

Simple PSEi (formerly known as PHISIX) RESTful API hosted on Google AppEngine

⚠️ IMPORTANT NOTICE: The public phisix-api.appspot.com service has been discontinued for legal reasons.
A takedown notice was received on November 30, 2023, and the service was shut down on December 4, 2023.
To access Philippine Stock Exchange data, please deploy your own instance using the instructions below.

Development & Deployment

Prerequisites

  • Java 17 (OpenJDK recommended)
  • Maven 3.6+
  • Google Cloud SDK (for App Engine deployment)
  • Git

Quick Start

  1. Clone the repository

    git clone https://github.com/phisix-org/phisix.git
    cd phisix
    
  2. Build the project

    mvn clean compile
    
  3. Run tests

    mvn test
    
  4. Run full verification (includes integration tests & code coverage)

    mvn clean verify
    
  5. Run locally (for development)

    mvn clean package appengine:run
    

Local Development

Running with App Engine Development Server

Note: Always use mvn clean package appengine:run during development to ensure:

  • Source code changes are recompiled
  • Tests are executed
  • Documentation changes are regenerated
  • Site content is updated with latest modifications
  • WAR file is properly packaged
  1. Stage the application (optional - for testing staging process)

    mvn clean package appengine:stage
    
  2. Run locally (recommended for development)

    mvn clean package appengine:run
    

    The API will be available at: http://localhost:8080

Test the local API

  • All stocks (JSON): http://localhost:8080/stocks.json
  • All stocks (XML): http://localhost:8080/stocks.xml
  • Specific stock: http://localhost:8080/stocks/BDO.json
  • Historical data: http://localhost:8080/stocks/BDO.2024-01-15.json

Deployment to Google App Engine

Prerequisites for Deployment

  1. Setup Google Cloud Project

    gcloud projects create your-project-id
    gcloud config set project your-project-id
    gcloud app create
    
  2. Enable App Engine API

    gcloud services enable appengine.googleapis.com
    
  3. Authenticate

    gcloud auth login
    gcloud auth application-default login
    

Deploy to App Engine

  1. Update pom.xml - Change the App Engine application name:

    <properties>
        <appengine.app.name>your-project-id</appengine.app.name>
    </properties>
    
  2. Deploy

    mvn clean package appengine:deploy
    

    Your API will be available at: https://your-project-id.appspot.com

Project Structure

phisix/
├── src/
│   ├── main/
│   │   ├── java/
│   │   │   └── com/googlecode/phisix/api/
│   │   │       ├── client/          # PSE website scraping clients
│   │   │       ├── ext/             # JAX-RS providers & filters  
│   │   │       ├── parser/          # HTML & JSON parsers
│   │   │       ├── repository/      # Data access layer
│   │   │       └── resource/        # REST API endpoints
│   │   ├── resources/               # Configuration files
│   │   └── webapp/
│   │       ├── WEB-INF/            # Web app configuration
│   │       └── schema/             # XSD schemas
│   └── test/                       # Unit & integration tests
├── target/                         # Build output
├── pom.xml                        # Maven configuration
└── README.md                      # Documentation

Technology Stack

  • Runtime: Java 17
  • Framework: JAX-RS (RESTEasy)
  • Platform: Google App Engine Standard
  • Build Tool: Maven
  • Data Binding: JAXB (XML), Gson (JSON)
  • Web Scraping: JSoup
  • Testing: JUnit, Mockito

Resources Summary

Stocks: look up stocks

GET http://localhost:8080/stocks.{json|xml}
GET http://localhost:8080/stocks/{symbol}.{json|xml}
GET http://localhost:8080/stocks/{symbol}.{yyyy-MM-dd}.{json|xml}

JSON feeds (Local Development Examples)

Symbol Name URL (when running locally)
- ALL http://localhost:8080/stocks.json
BDO BDO UNIBANK, INC. http://localhost:8080/stocks/BDO.json
BPI BANK OF THE PHILIPPINE ISLANDS http://localhost:8080/stocks/BPI.json
CBC CHINA BANKING CORPORATION http://localhost:8080/stocks/CBC.json
COL COL FINANCIAL GROUP, INC. http://localhost:8080/stocks/COL.json
EW EAST WEST BANKING CORPORATION http://localhost:8080/stocks/EW.json

XML feeds (Local Development Examples)

Symbol Name URL (when running locally)
- ALL http://localhost:8080/stocks.xml
MBT METROPOLITAN BANK & TRUST COMPANY http://localhost:8080/stocks/MBT.xml
PNB PHILIPPINE NATIONAL BANK http://localhost:8080/stocks/PNB.xml
PSE THE PHILIPPINE STOCK EXCHANGE, INC. http://localhost:8080/stocks/PSE.xml
RCB RIZAL COMMERCIAL BANKING CORPORATION http://localhost:8080/stocks/RCB.xml
SECB SECURITY BANK CORPORATION http://localhost:8080/stocks/SECB.xml

XSD Schema

When running locally: http://localhost:8080/schema/stocks/phisix-stocks.xsd