Skip to main content

SurgeFlow Screening Methodology

How we source, clean, enrich, and score 17,000+ stocks across 6 global markets daily. Platform v2.0.0 · Ratio Schema v1.1.0.

Market Data Sources

Each market is sourced from a specialized provider optimized for coverage, latency, and reliability. Data is ingested daily after each market close.

MarketSourceTypeRefresh Timing
United StatesFMPbatch quotes + historicaldaily 16:05 ET
JapanJ-Quantsdaily_quotes APIdaily 15:00 JST + 60min
ChinaTusharepro.daily()daily 15:00 CST + 2h
United KingdomFMPhistorical per-tickerdaily 16:30 GMT + 1h
IndiaFMPhistorical per-tickerdaily 15:30 IST + 1.5h
Hong KongTusharepro.hk_daily()daily 16:00 HKT + 2h

Fundamental Data

Fundamental data is refreshed weekly (Sunday) from multiple sources: FMP (US/UK/IN), J-Quants (JP), Tushare (CN/HK), Yahoo Finance (revenue fallback).

Enrichment Pipeline

  • 1.shares_out: 4-step validation (backfill → cross-check inflated → fix deflated → final gate)
  • 2.sectors: GICS-normalized (US SIC→GICS, JP TSE33→GICS, CN Tushare L2→GICS)
  • 3.revenue: Yahoo Finance fallback for financial institutions where FMP understates
  • 4.micro-cap quarantine: fundamentals NA'd if market_cap < $7M USD

Ratio Definitions

All ratios are computed as yield-style metrics (higher = cheaper/better) for consistent cross-market comparison.

RatioDefinition
epnet_income / market_cap (higher = cheaper)
sprevenue / market_cap (higher = cheaper)
bptotal_equity / market_cap (higher = cheaper)
cfopcfo / market_cap (higher = better)
dividend_yielddividends_paid / market_cap (higher = better)
profit_marginnet_income / revenue
revenue_growthYoY revenue change from fund_hist

Quality Labels

Every stock receives a quality label based on the completeness and consistency of its fundamental ratios.

good
All 4 ratios present and within sanity bounds
acceptable
1-3 ratios present, rest null
suspect
Ratios present but flagged (e.g. ep > sp for industrial)
unusable
All 4 ratios null — micro-cap or no fundamentals

Exclusion Criteria

The following categories are excluded from the screening universe to maintain data integrity.

ADRsExcluded from US screen (currency mismatch)
non equityPreferred shares, SPACs, LPs, units, debt instruments
delistedFMP isActivelyTrading = false
micro cap fundamentalsFundamentals NA'd if market_cap < $7M (price/turnover preserved)

Whale / Institutional Holdings

Institutional fund holdings are tracked from regulatory filings across three major markets.

usWhaleWisdom (SEC 13F filings), 20 institutional funds, quarterly
cnAkShare (基金持仓), 20 mutual funds, quarterly top 10
jpEDINET (大量保有報告書), 16 funds, 5%+ stake events

Macro & Economic Data

Macro indicators power the economic dashboard with real-time market indices, FX rates, and forecasts.

realtimeFMP live quotes (10s cache) — 8 indices + 5 FX + VIX + DXY
indicatorsTradingEconomics (214 indicators, 32 countries, weekly refresh)
forecastsARIMA (auto.arima in R, 221 series, 80%/95% CI, 2-year horizon)