SurgeFlow exposes a free, read-only JSON API over the same evidence-aware equity research used by the website. Create one member key for 15 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 — Eight-market market-watch summary, freshness metadata, and FX context.GET /api/v1/markets/{market}/screen — Paged institutional market screen for all eight 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/ai/ratings — AI panel scores, comments, tenure, and paper-only state for the US hotlist.GET /api/v1/ai/grade-book — Deterministic paper grade book with outcomes and six-area rationale gates.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 — Publication-gated factor portfolios, risk statistics, holdings, and returns.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, AI ratings and the deterministic paper grade book, ML clusters, institutional holdings, sector and news reads, factor portfolios, Daily Notes, macro releases, and bond ETFs. Coverage, freshness, and source depth vary by market and are disclosed rather than filled with invented values.