The WiseView API

How a call looks

Every call is an HTTPS GET to https://api.wiseview.ai/v1/…, with your key in the request’s header as Authorization: Bearer <your key>. Every answer is JSON.

curl "https://api.wiseview.ai/v1/premarket/board" \
  -H "Authorization: Bearer $WISEVIEW_API_KEY"

Every sample in this book reads the key from an environment variable, WISEVIEW_API_KEY, so a script you share never carries it.

Start here

• Keys →Who can have one, where to make it, and how to send it.
• Calls and limits →Your monthly allowance of calls, and the speed limit.
• Answers and errors →The shape of every answer, and what an error carries.

Endpoints

WiseView's research

The pre-market board, its 10:00 confirmation and its graded record, the equity screener and the mean-reversion scanner, Congress, insiders, the value chain and the squawk's log of the day.

• Pre-market board →GET /v1/premarket/board — This morning's pre-market board: the stocks in play, each with its pre-market move, volume against usual, the catalyst behind it and the board's levels.
• 10:00 confirmation →GET /v1/premarket/confirmation — The board's 10:00 AM Eastern check: which of the morning's names held up after the open — above yesterday's high, above the pre-market high, at the session high, in a long-term uptrend — with each name's levels and the near misses.
• Board track record →GET /v1/premarket/track-record — How the board's past picks finished over the last N trading days: how many there were and how often each list worked.
• Run a screen →GET /v1/screener — Run the equity screener on your own filters: the matching stocks with the columns the view names, at most limit of them, and how many matched in all.
• Run a saved screen →GET /v1/screener/screens/{id} — Run one of the screener's ready-made screens, or one of your saved screens, by its id from the screener filter list: the matching stocks, answered the way a screen of your own filters is.
• Screener filter list →GET /v1/screener/filters — Everything the equity screener can run: the ready-made screens and your saved screens (each with its id and filters), every filter as a token with its plain label, by family, and the signals.
• Mean-reversion scanner →GET /v1/screener/mean-reversion — Today's mean-reversion scan: stocks stretched far from their statistical equilibrium, each with how far (its z-score), how fast such moves have tended to revert, and the odds.
• Congress trades →GET /v1/congress/trades — Stock trades disclosed by members of Congress under the STOCK Act, newest first, by ticker or by member: who traded, their chamber and party, the trade date and disclosure date, buy or sell, and the amount range.
• Congress trading activity →GET /v1/congress/members — How much members of Congress trade — not how well; their returns are a separate lookup.
• Congress returns →GET /v1/congress/returns — An estimate of how a member of Congress's stock purchases in one year have done since: each purchase priced on its trade date at the midpoint of its disclosed amount range, then marked to today's price, across their ten most-traded stocks.
• Congress buying patterns →GET /v1/congress/stocks — Which stocks members of Congress are converging on.
• Insider trades →GET /v1/insider/trades — A company's insiders' buys and sells from SEC Form 4 filings, with a buy-to-sell summary.
• Value chain →GET /v1/companies/{symbol}/value-chain — A company's suppliers, customers, partners and competitors from WiseView's value-chain map, with the evidence for each link.
• Squawk log →GET /v1/squawk/today — The headlines the squawk would read you today, as text, each with its size.

Market context

Quotes and symbol search, company figures, earnings, dividends and short interest, price history and indicators, news, calendars, movers, Treasury yields, futures and halts.

• Quotes →GET /v1/quotes — Up to 50 stocks in one call: price, change, volume and day range.
• Symbol search →GET /v1/search — Find a stock by its ticker or by its company name: each match with its ticker, name and exchange.
• Futures and markets →GET /v1/market/snapshot — The markets strip in one call: stock index futures, the VIX, the 10-year yield, gold, silver, crude, natural gas, Bitcoin, Ether and the major index funds, each with its price, change and day and year ranges.
• Trading halts →GET /v1/market/halts — Which stocks are halted right now on Nasdaq or the NYSE, from their own published halt lists, checked at most once every 45 seconds.
• Company profile →GET /v1/companies/{symbol} — What a company does, its sector and industry, size, and key figures.
• Peers →GET /v1/companies/{symbol}/peers — A company's peers: companies in the same line of business and of a similar size, each with its price and market value.
• Financial statements →GET /v1/companies/{symbol}/financials — A company's income statement, balance sheet or cash flow, annual or quarterly, or its revenue by product or by region.
• Valuation and ratios →GET /v1/companies/{symbol}/valuation — A company's key metrics and ratios (P/E, margins, returns, debt), enterprise value, a fair-value estimate, and its Altman Z and Piotroski scores.
• Earnings history →GET /v1/companies/{symbol}/earnings — A company's recent quarterly results against what analysts expected: earnings per share and revenue, each beside its estimate, newest first, so every beat and miss shows.
• Dividend history →GET /v1/companies/{symbol}/dividends — A company's dividends, newest first: each payment's amount, its ex-dividend, record and payment dates, and the yield.
• Analyst view →GET /v1/companies/{symbol}/analysts — Sell-side analysts' price targets, the ratings consensus, and recent upgrades and downgrades.
• Ownership and filings →GET /v1/companies/{symbol}/ownership — Who owns a company — institutional holders and 13D/G stakes — and its recent SEC filings.
• Short interest and short volume →GET /v1/companies/{symbol}/short-stats — How heavily a stock is sold short, from FINRA's own publications: short interest at each twice-monthly settlement (with days to cover), and each day's off-exchange short volume as a share of all volume.
• ESG ratings →GET /v1/companies/{symbol}/esg — A company's environmental, social and governance scores over time, newest first.
• Earnings call transcripts →GET /v1/companies/{symbol}/earnings-calls — Without year and quarter, which quarters have an earnings call transcript.
• Daily prices →GET /v1/prices/{symbol}/daily — Daily bars — open, high, low, close, volume — newest first.
• Technical indicators →GET /v1/prices/{symbol}/indicators — Technical indicators on daily bars — moving averages (SMA, EMA, WMA, DEMA, TEMA), RSI, Williams %R, ADX and standard deviation — computed by WiseView from the same stored bars the chart draws.
• News →GET /v1/news — Recent market headlines WiseView has scored for importance (0-100), newest first.
• Press releases →GET /v1/news/press-releases — The latest press releases companies have put out, across the market, newest first.
• Calendars →GET /v1/calendar — Upcoming events: company earnings dates with estimates, economic releases with forecasts, dividends, or IPOs.
• Market movers, sectors and industries →GET /v1/market/movers — Today's biggest gainers, decliners or most active stocks, or how each sector or each industry did on the latest trading day.
• Treasury yields →GET /v1/market/treasury-yields — US Treasury yields across the curve, one-month to 30-year, one row a day, newest first.

Your account

Your own watchlists, alerts, trade plans and research reports, and how many calls you have left.

• Your watchlists →GET /v1/me/watchlists — Your WiseView watchlists and the names on each.
• Your price alerts →GET /v1/me/alerts — Your price alerts and whether each is armed, newest first.
• Your trade plans →GET /v1/me/trades — The trade plans you accepted from your research reports, newest first: each one's entry zone, stop and targets, whether it is waiting, open or closed, and what it made.
• Your research reports →GET /v1/me/reports — The research reports you made in WiseView, newest first, each with its id.
• One research report →GET /v1/me/reports/{id} — The full text of one of your research reports, and its trade playbook when it has one.
• Your calls →GET /v1/me/usage — How many calls you have used and have left, and when they refill.