Skip to main content

Philippine Securities Engine (phse)

CLI-first, modular tool for monitoring, analyzing, and generating trading recommendations for the Philippine Stock Exchange (PSE). Terminal-native output with rich formatting, SQLite caching, and interactive charts.

Features

  • Live quotes — Real-time price, volume, change with EOD-frozen SQLite caching
  • Historical data — OHLCV history (1m/3m/6m/1y) with multi-period support
  • Technical analysis — 7 indicators (SMA, EMA, RSI, MACD, Bollinger, ATR, VWAP) with composite scoring
  • Signal engine — BUY/HOLD/SELL signals from SMA/EMA crossovers, RSI thresholds, Bollinger breaks, MACD histogram
  • Backtesting — SMA crossover strategy with total return, win rate, max drawdown, Sharpe ratio
  • Interactive charts — TradingView-style candlestick charts with volume + indicator overlays
  • Market scan — Filter by sector, price range, volume; sort by change/volume/price; fast --bulk mode (1 HTTP call vs 368)
  • Watchlist — Add/remove/list/clear symbols with JSON storage
  • Price alerts — Set above/below thresholds, check triggers, reset alerts
  • Fundamentals — P/E, P/BV, market cap, 52-week range, book value
  • Dividend tracker — Track ex-dates, payment dates, dividend types
  • Signal explanation — See contributing factors behind each composite signal
  • Market recap — Top gainers, losers, volume leaders at a glance
  • Dual data sources — PSE Edge (rich data) + frames.pse.com.ph (fast fallback) with automatic merging
  • Bootstrap — Bulk download historical data for all or selected symbols

Install

pip install phse-cli[chart]   # with chart support
# or
pip install phse-cli           # CLI only

From Source (development)

git clone https://github.com/linellazatin/phse-cli.git
cd phse
pip install -e ".[chart]"   # with chart support
# or
pip install -e .           # CLI only

Update

# From PyPI
pip install --upgrade phse-cli[chart]

# From source
git pull
pip install -e .

Quick Start

# List all PSE-listed companies
phse list

# View a stock quote
phse quote DMC

# View historical prices
phse history DMC --period 6m

# Scan for top gainers/losers
phse scan --top-gainers
phse scan --top-losers
phse scan --symbols DMC,FGEN,GCASH

# Technical analysis
phse analyze DMC
phse analyze DMC --period 1y

# Signal explanation
phse why DMC

# Market recap
phse recap

# Market-wide signals
phse signals --buy
phse signals --symbols DMC,FGEN

# Backtesting
phse backtest DMC --period 1y

# Interactive charts
phse chart DMC --period 1y
phse chart FGEN --no-indicators

Test Symbols

Symbol Company Notes
GCASH Mynt, Inc. Listed Oct 20, 2026 — limited history. Use for scraper validation.
DMC DMCI Holdings, Inc. Long history — primary test symbol
FGEN First Gen Corporation Long history — primary test symbol

Commands

Market Data

Command Description
phse list [--force] List all PSE-listed companies (cached, refreshes daily)
phse quote <SYMBOL> [--latest] Show latest stock quote (price, volume, change)
phse history <SYMBOL> [-p 1m|3m|6m|1y] Show historical OHLCV data
phse-bootstrap [SYMBOLS...] [--all] Bootstrap historical data for symbols

Analysis

Command Description
phse analyze <SYMBOL> [-p 1y] Full technical analysis with indicators, signals, support/resistance
phse signals [-b/--buy] [-s/--sell] [-S symbols] [-p 1m|3m|6m|1y] Market-wide signal scan with BUY/SELL/HOLD filtering
phse backtest <SYMBOL> [-p 1y] [-s 7] [-l 20] SMA crossover backtest with P&L stats

Charts

Command Description
phse chart <SYMBOL> [-p 1y] [--indicators/--no-indicators] [--block/--no-block] Interactive candlestick chart with volume + indicator overlays

Watchlist & Alerts

Command Description
phse watchlist list List watchlist symbols
phse watchlist add --symbol DMC Add symbol to watchlist
phse watchlist remove --symbol DMC Remove symbol from watchlist
phse watchlist clear Clear entire watchlist
phse alert add --symbol DMC --threshold 6.00 --below Set price alert
phse alert list List all alerts
phse alert check --symbol DMC Check if alerts triggered
phse alert reset Reset triggered alerts

Fundamentals & Dividends

Command Description
phse fundamentals DMC Show company financial metrics
phse dividend list List all dividend records
phse dividend upcoming Show upcoming dividends
phse dividend add --symbol DMC --ex-date 2026-12-15 --payment-date 2027-01-15 --amount 0.50 Add dividend record

Utilities

Command Description
phse about Show tool info, version, data source

Scan Options

phse scan --top-gainers          # Top 10 gainers
phse scan --top-losers           # Top 10 losers
phse scan --most-active          # Top 10 by trading value
phse scan --symbols DMC,FGEN     # Target specific stocks (bypasses full scan)
phse scan -n 20                  # Limit results
phse scan --sort volume          # Sort by: symbol, change, volume, price
phse scan --price-min 10 --price-max 100  # Price range
phse scan --min-volume 1000      # Minimum volume filter

Fast Bulk Scan

phse scan --bulk                 # All 367 stocks in ~1-2s (was 120s+)
phse scan --bulk --top-gainers   # Fast top gainers
phse scan --bulk --enrich        # Add market_cap/P-E via pse_edge
phse scan --bulk --symbols GCASH,FGEN,DMC  # Fast per-symbol lookup

Technical Analysis

Indicators

Indicator Period Description
SMA 7, 20, 50, 200 Simple Moving Average
EMA 12, 26 Exponential Moving Average
RSI 14 Relative Strength Index
MACD 12, 26, 9 Moving Average Convergence Divergence
Bollinger Bands 20, 2 Price volatility bands
ATR 14 Average True Range (volatility)
VWAP — Volume Weighted Average Price

Signal Engine

  • SMA Crossovers: Golden cross (SMA 7 > 20), Death cross (SMA 50 < 200)
  • EMA Crossover: EMA 12 vs EMA 26
  • RSI: >70 overbought, <30 oversold
  • Bollinger: Price above upper (sell), below lower (buy)
  • MACD: Histogram direction and signal line crossover
  • Composite Score: Weighted aggregation → BUY/HOLD/SELL with confidence %

Backtesting

phse backtest DMC --period 1y --short 7 --long 20

Outputs: total return, win rate, max drawdown, Sharpe ratio.

Architecture

phse-cli/
├── phse/
│   ├── cli.py              # Typer CLI with all commands
│   ├── config.py           # Settings (cache dir, throttle, etc.)
│   ├── analysis/
│   │   ├── __init__.py     # Package exports
│   │   ├── models.py       # IndicatorResult, Signal, AnalysisResult
│   │   ├── indicators.py   # SMA, EMA, RSI, MACD, BB, ATR, VWAP
│   │   ├── signals.py      # Signal engine + composite scoring
│   │   └── backtest.py     # SMA crossover backtest engine
│   ├── chart/
│   │   ├── __init__.py     # Package exports
│   │   └── renderer.py     # lightweight-charts-python renderer
│   ├── data/
│   │   ├── __init__.py     # Package exports
│   │   ├── pse_edge.py     # PSE Edge scraper (HTML/AJAX)
│   │   ├── frames_pse.py   # frames.pse.com.ph JSON parser
│   │   ├── unified.py      # Auto-merges frames_pse + pse_edge
│   │   ├── cache.py        # SQLite caching layer
│   │   ├── exceptions.py   # Custom exceptions
│   │   └── models.py       # Company, Quote, OHLCV models
│   ├── scan/
│   │   ├── __init__.py     # Package exports
│   │   └── screener.py     # Stock screener with filters
│   ├── watchlist/
│   │   ├── __init__.py     # Package exports
│   │   ├── watchlist.py    # Watchlist CRUD
│   │   └── alerts.py       # Price alert management
│   ├── recap/
│   │   ├── __init__.py     # Package exports
│   │   └── recap.py        # Market recap (top gainers/losers)
│   ├── fundamentals/
│   │   ├── __init__.py     # Package exports
│   │   └── fundamentals.py # Company financial metrics
│   ├── dividends/
│   │   ├── __init__.py     # Package exports
│   │   └── dividends.py    # Dividend tracking
│   └── why/
│       ├── __init__.py     # Package exports
│       └── why.py          # Signal explanation
├── tests/
│   ├── test_phse_cli.py   # Core scraper & model tests
│   ├── test_analysis.py    # Indicator, signal, backtest tests
│   └── test_chart.py       # Chart rendering tests
├── scripts/
│   └── bootstrap_data.py   # Historical data bootstrap
├── pyproject.toml
└── README.md

Data Source

Primary: PSE Edge via HTML/AJAX scraping

  • Company list: POST /companyDirectory/search.ax (paginated)
  • Quote: GET /companyPage/stockData.do?cmpy_id=X
  • History: POST /common/DisclosureCht.ax (AJAX with cmpy_id, security_id, dates)

Secondary: frames.pse.com.ph via JSON parsing

  • Quote: Embedded JSON in hidden input field (fast, lightweight)
  • Company list: Same JSON (388 entries, filters to ~367 stocks)

Unified client merges both: frames price + pse_edge OHLC/market cap/P/E.

No API key required. Prices are EOD-frozen in SQLite cache; metadata refreshes daily.

Caching

SQLite cache at ~/.phse-cli/cache.db:

Table Refresh Policy
companies Daily
quotes EOD-frozen
ohlcv EOD-frozen

Tech Stack

  • CLI: Typer (auto-help, fast development)
  • HTTP: httpx (async HTTP client)
  • HTML Parsing: lxml
  • Data Models: Pydantic
  • Analysis: pandas + ta library
  • Charts: lightweight-charts (TradingView engine)
  • Cache: SQLite (zero-config)
  • Testing: pytest

Tests

pytest tests/ -v          # All tests
pytest tests/test_analysis.py -v   # Analysis module
pytest tests/test_chart.py -v      # Chart module

CLI Reference

phse --help                          # Show all commands
phse COMMAND --help                  # Show command help
phse watchlist --help                # Watchlist help
phse alert --help                    # Alert help
phse dividend --help                 # Dividend help

Known Issues

  • Chart semaphore leak: phse chart may leave leaked multiprocessing semaphores on exit. This is a known issue with lightweight-charts-python and doesn't affect functionality.
  • P/E, P/BV, Book Value: These fields show "N/A" because PSE Edge doesn't provide them in the quote page. They would need to be scraped from a fundamentals page or fetched from an alternative source.
  • Sector display: Sector information is populated from PSE Edge. If PSE Edge is down, phse list falls back to frames.pse.com.ph data with empty sector/listed date columns and shows a warning.
  • PSE Edge availability: phse list now includes a health check for PSE Edge. When PSE Edge is down, the command degrades gracefully using frames.pse.com.ph data (symbol + name only, no sector). The health check is cached for 5 minutes.

Development

This small tool was built alongside a fully local Qwen3.6 model, served under the following specifications:

  • Inference server: llama.cpp (llama-server)
  • Consumer-grade, mid-tier PC
    • OS: Fedora 45 Workstation Edition (through isolate multi-user.target)
    • GPU: AMD Ryzen 7 7700X
    • GPU: AMD Radeon RX 7700XT 12GiB
    • RAM: 32GiB

License

MIT

Metadata

Release files for phse-cli 0.2.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for phse-cli 0.2.0
File Size Uploaded Provenance Actions
phse_cli-0.2.0.tar.gz 46.6 kB With provenance Details for phse_cli-0.2.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for phse-cli 0.2.0
File Interpreter ABI Platform Actions
phse_cli-0.2.0-py3-none-any.whl Python 3 none any Details for phse_cli-0.2.0-py3-none-any.whl

Total release size: 95.6 kB

Release files / phse_cli-0.2.0.tar.gz

Download URL phse_cli-0.2.0.tar.gz
Size 46.6 kB
Tags Source
SHA-256 checksum
How to use checksums
9bbb0b8c9ac7e14db0c233a3af6a81354633cc1ff754a9ea09bc071c5a72d6ce
BLAKE2b-256 checksum
How to use checksums
0dc24c770dcbda8af65081c1cd23d2f2abf0f274929885a3b5a265edeb126862
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 14, 2026.

Transparency log

Release files / phse_cli-0.2.0-py3-none-any.whl

Download URL phse_cli-0.2.0-py3-none-any.whl
Size 48.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
0281c65863d5a972cc7bd4f13159833682e1874587bf49b37edd309dfa5c8367
BLAKE2b-256 checksum
How to use checksums
221ce9d08cdfbb6f51bce4056576ae46029d308cbc9cc807a23bf6135682de44
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 14, 2026.

Transparency log

Security for phse-cli 0.2.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for phse_cli-0.2.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 14, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.2.0 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page