SurgeFlow exposes a free, read-only JSON API over the same evidence-aware equity research used by the website. Create one member key for 14 authenticated endpoint families, plus 3 open endpoints. No payment card is required. Research, not investment advice.
GET /api/v1/health — Operational health and data-quality disclosures.GET /api/v1/catalog — Stable endpoint catalogue, plans, limits, and schemas.POST /api/v1/keys — Self-serve free beta API key with email and terms agreement.GET /api/v1/me — Active-key plan, scopes, and rolling usage without exposing the secret.GET /api/v1/summary — Four-market market-watch summary, freshness metadata, and FX context.GET /api/v1/markets/{market}/screen — Paged institutional market screen for all four covered markets.GET /api/v1/markets/{market}/realtime — Spreadsheet-safe realtime turnover board.GET /api/v1/markets/{market}/hotlist — Spreadsheet-safe momentum hotlist.GET /api/v1/markets/{market}/ml/clusters — ML cluster profiles, anomaly watch, and stability diagnostics.GET /api/v1/markets/{market}/whales — Institutional consensus, conviction, crowdedness, and position changes.GET /api/v1/markets/{market}/sector — Ticker, sector, and industry performance with institutional context.GET /api/v1/markets/{market}/news — Latest scored news with sentiment, tickers, and keywords.GET /api/v1/markets/{market}/factor-portfolios — Weekly style-tilted long-only books (three-model, model A; market exposure 1, own style 1 by characteristic, other styles 0; not pure factor portfolios — return-beta-pure books replace them after verification): publication, weekly series, exposures, realised gross weekly returns, holdings on request, caveats and return basis.GET /api/v1/markets/{market}/factor-portfolios/meta — Publication metadata for the weekly style-tilted long-only books (not pure factor portfolios): publications, model state and window, universe, cost basis, caveats and return basis.GET /api/v1/notes/daily — Complete per-market and global Daily Notes research.GET /api/v1/macro/calendar — Macro release calendar with consensus, actuals, and surprises.GET /api/v1/bond/etfs — Bond ETF assets, expenses, closes, and trailing returns.The free member beta includes 2000 requests per day and 180 per minute. Limits are stated up front, and the read-only API never places trades or moves money.
curl -H "Authorization: Bearer sf_live_..." "https://surgeflows.capital/api/v1/markets/us/screen?limit=50"Responses cover screens, realtime momentum, hotlists, ML clusters, institutional holdings, sector and news reads, the weekly style-tilted long-only factor books, Daily Notes, macro releases, and bond ETFs. The AI committee is paused and its two endpoints are retired. Coverage, freshness, and source depth vary by market and are disclosed rather than filled with invented values.