Free Cross-Market Equity Data API (2026)
A free cross-market equity and disclosure data API across 4 markets: real endpoints, 2,000 requests/day, OpenAPI, JSON/CSV snapshots, and an llms.txt AI index.
Category: Data & API
What is SurgeFlow's free cross-market equity data API? SurgeFlow offers a free cross-market equity data API covering four markets — US, China (A-shares), Japan (TOPIX) and Hong Kong (HKEX). It serves realtime, screen and hotlist endpoints plus a summary feed, capped at 2,000 requests/day, with an OpenAPI spec, open JSON/CSV snapshots and an llms.txt index. It is research data, not investment advice.
The edge is breadth, not just access. Most free feeds stop at US equities; SurgeFlow extends the same schema across developed and Asian markets, and pairs price data with regulatory disclosure data — large-holding and major-holder filings — so you can study who owns what alongside what it trades for. The API is in beta and intended for research, prototyping and analysis rather than production trading systems. - Four markets under one consistent schema, including three Asian markets - Endpoints: /api/v1/markets/{market}/realtime, /screen, /hotlist, and /api/v1/summary - 2,000 requests/day on the free tier, all markets included - OpenAPI spec at /api/public/openapi.json, plus open JSON/CSV snapshots - An /llms.txt index so AI agents and assistants can discover the data
Endpoints, formats and limits
The public surface is deliberately small and predictable. Per-market endpoints follow the pattern /api/v1/markets/{market}/realtime for current quotes, /screen for filtered universes, and /hotlist for ranked momentum-style candidate lists, where {market} is one of us, cn, jp or hk. A cross-market roll-up lives at /api/v1/summary. The machine-readable contract is published at /api/public/openapi.json, so you can generate a typed client in any language rather than hand-coding request shapes.
For bulk and reproducible work, SurgeFlow also publishes open JSON and CSV snapshots, which avoid burning request quota when you need a full table rather than a single lookup. The free tier is capped at 2,000 requests/day across all markets; this is a research allowance, so design around snapshots for batch jobs and reserve live calls for interactive queries. The /llms.txt file gives language-model agents a structured map of available routes and data, which is useful if you are building a research assistant on top of the feed. - Realtime, screen and hotlist are per-market; summary is cross-market - OpenAPI at /api/public/openapi.json generates typed clients automatically - JSON/CSV snapshots cover bulk pulls without spending request quota - 2,000 requests/day is a research quota — batch via snapshots, not loops
Methodology: how the underlying research data is built
Beyond raw prices, SurgeFlow exposes a factor research stack built in the Fama-French tradition. The factor set covers SMB (size), HML (value), RMW (profitability), CMA (investment), WML (momentum) and LIQ (liquidity), with daily factor returns. Factors are estimated in the standard cross-sectional way — portfolios are sorted on each characteristic and a long-short return is computed each period, the same logic that underpins Fama-MacBeth cross-sectional regressions, where per-period coefficients are averaged to test whether a characteristic is priced.
Quality control is explicit. A publication gate blocks factors that fail to clear robustness criteria, so an unpublishable factor does not silently leak into the output; an effective-direction resolver fixes each factor's economic sign; and VIF (variance inflation factor) diagnostics flag multicollinearity among correlated factors. Factor Backtest V2 then builds long sleeves of single and combined factors under two weightings — equal weight (EW) and risk parity (RP), where RP scales each position inversely to its volatility so risk, not capital, is balanced. Each sleeve reports Sharpe (excess), annualized Information Ratio, max drawdown, turnover and observation count. Data-quality gates require point-in-time data, survivorship handling, and a minimum-observations floor; the GRS test (Gibbons-Ross-Shanken), a joint F-test of whether portfolio alphas are collectively zero, is reported as a diagnostic rather than used as a portfolio exclusion gate. The current Phase 1 run is research_backtest_insample, so treat it as in-sample factor-attribution evidence, not a live out-of-sample track record. The current US composite winner — selected by argmax of 0.5·z(Sharpe) + 0.5·z(Information Ratio) — is the WML+RMW Top-30 RP sleeve over roughly ten years, and it ranks first by both Sharpe and Information Ratio. Concrete factor premia, weights and Sharpe values are not quoted here; read the live values on /factors and /backtesting or pull them through the API. - Fama-French six-factor set: SMB, HML, RMW, CMA, WML, LIQ, daily returns - Fama-MacBeth-style cross-sectional estimation; GRS joint test of alphas - Publication gate + effective-direction resolver + VIF multicollinearity checks - Backtest V2: EW vs RP sleeves; Sharpe, Information Ratio, drawdown, turnover - US composite winner: WML+RMW Top-30 RP, ~10y, #1 by both Sharpe and Info Ratio
What SurgeFlow data this uses
The API is sourced per market from documented providers, and disclosure data comes from primary regulatory feeds. US price and fundamentals data come from FMP; China and Hong Kong from Tushare; and Japan from J-Quants, with large-holding reports from EDINET. US institutional ownership uses SEC EDGAR 13F filings.
This provenance is what powers the realtime, screen and hotlist endpoints and the factor stack above. Ownership and disclosure data — visible in aggregate on the /whales view — is built from these primary filings, with the signal dated to the disclosure date rather than backdated, which matters for any point-in-time research. Coverage and freshness differ by market because the upstream sources differ; where a mature model does not yet exist for a given market or factor, the page and API expose the data and methodology we do have rather than asserting a result.
Cross-market honesty: coverage and caveats
Cross-market research is valuable precisely because factor behaviour is not uniform across regions, and the academic record is explicit about this. For China A-shares, Liu, Stambaugh and Yuan (2019, 'Size and value in China', Journal of Financial Economics) document that size and value premia are strong while price momentum is weak or absent — a published finding you can verify, not a SurgeFlow result. We surface the data so you can study these differences yourself; we do not claim a proprietary edge over the academic literature.
Two honest limits apply. First, this is research data, not investment advice — there are no recommendations, price targets or buy/sell/hold signals anywhere in the API or these pages. Second, the API is in beta with a free-tier quota, coverage and freshness vary by market and source, and some markets have more mature factor models than others. Treat outputs as inputs to your own analysis. For methodology background see /research/fama-french-factor-backtesting and the per-market coverage notes.
Get a free API key
Create a free API key and start querying four markets in minutes. Head to /membership to become a member, generate a key on /account, and try the endpoints in the live console — call /api/v1/summary for a cross-market snapshot, or hit /api/v1/markets/{market}/realtime for any of the four markets. Point your generated client at /api/public/openapi.json, or feed /llms.txt to an AI agent to let it discover the data on its own. The free tier includes 2,000 requests/day across all markets, with open JSON/CSV snapshots for batch work. It is research data and the service is in beta, so build and explore accordingly — then start at /membership.
Sources and further reading
Primary, academic, and SurgeFlow data references for the claims above: - Fama, E. F., & French, K. R. (1993). Common risk factors in the returns on stocks and bonds. Journal of Financial Economics. - Fama, E. F., & French, K. R. (2015). A five-factor asset pricing model. Journal of Financial Economics. - Fama, E. F., & MacBeth, J. D. (1973). Risk, return, and equilibrium: Empirical tests. Journal of Political Economy. - Gibbons, M. R., Ross, S. A., & Shanken, J. (1989). A test of the efficiency of a given portfolio. Econometrica. - Liu, J., Stambaugh, R. F., & Yuan, Y. (2019). Size and value in China. Journal of Financial Economics.