phisix
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
-
Clone the repository
git clone https://github.com/phisix-org/phisix.git cd phisix
-
Build the project
mvn clean compile
-
Run tests
mvn test
-
Run full verification (includes integration tests & code coverage)
mvn clean verify
-
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
-
Stage the application (optional - for testing staging process)
mvn clean package appengine:stage
-
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
-
Setup Google Cloud Project
gcloud projects create your-project-id gcloud config set project your-project-id gcloud app create
-
Enable App Engine API
gcloud services enable appengine.googleapis.com
-
Authenticate
gcloud auth login gcloud auth application-default login
Deploy to App Engine
-
Update
pom.xml
- Change the App Engine application name:<properties> <appengine.app.name>your-project-id</appengine.app.name> </properties>
-
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