P-Invertor API

GET/api/pages/index

Every figure on the Overview tab's market cards, for either market and any of the three period toggles — indices, FX and commodities, capital and fund flows, sector scores, breadth, timing signals, VIX, fear & greed, and bonds.

• market: US or HK (default: US)
• period: 5, 20, or 60 days (default: 5) — the 5 Days / 20 Days / 60 Days toggle. Any other value returns 422.
• include_raw: set to false for the smaller, normalized response only

The response's as_of field is the snapshot timestamp — use it to tell fresh data from cached. This endpoint only ever reads the published snapshot; to make it produce newer numbers, queue a refresh (below).

Copy

GET/api/market-trends/{view}

The Overview tab's five research sub-tabs. Each name below is the {view} value, so all five share one URL shape.

• signals — the 60-second scan: anomalies, trending up/cooling, sector heat, headline metrics, source health. Also available as /api/market-trends/overview.
• emerging — opportunity discovery across filings, search, reading, and communities
• explore — normalized multi-metric comparison series, including the preset metric sets
• niches — tracked verticals as composite z-scores, with their component evidence
• anomalies — the full statistical-outlier register (|z| ≥ 2), latest first

Every response carries status and latest_metric_date. A status other than ok/cached means the trend pipeline has not published recently — check latest_metric_date before treating the numbers as current. Any other {view} returns 404.

Copy

Refreshing Overview data

The read endpoints above always serve the last published snapshot; they never scrape on demand. To produce newer data, queue a refresh — one call re-runs everything on the Overview tab: the market snapshot behind the 5/20/60-day toggles, and all five trend sub-tabs.

• POST/api/refresh-data — queues the refresh. Send your key in X-API-Key. Returns {"status": "queued"}; it does not wait for completion.
• GET/api/refresh-data/status — poll progress. No key required. active is true while a run is in flight; when it flips to false, re-read the endpoints above and confirm as_of / latest_metric_date has moved.

Copy

Private personal-data API

For your own analysis applications only. Send the private key in X-API-Key; never place it in browser code.

• GET/api/v1/stocks/{symbol}/quote — delayed price with source and freshness
• GET/api/v1/stocks/{symbol}/filings — US SEC filing timeline
• GET/api/v1/stocks/{symbol}/financials — US SEC XBRL financial facts
• GET/api/v1/stocks/{symbol}/news — Finnhub company news
• POST/api/v1/data-refresh then GET/api/v1/jobs/{job_id} — refresh and poll a job
• POST/api/v1/data-refresh/active — hourly refresh of watchlist, open positions, and research pins
• GET/PUT/api/v1/tracked-symbols — read or replace explicit research pins
• GET/POST/api/v1/portfolio — personal transaction-led portfolio

Copy

GET/api/pages/predictor/{symbol}

Returns a stock’s current technical figures and, by default, the chart-ready OHLCV and indicator series.

• period: 1d, 1w, 1m, 3m, 6m, 12m, 2y, 3y, or 5y
• interval: daily, weekly, or monthly
• include_series: set to false for current card figures only

Copy

Integration notes

Predictor snapshots use the built-in default profile. Personal browser-only profiles, peer lists, custom signals, and interactive backtest inputs are not shared because they are user-specific.