Skip to content
Practical recipe library

Turn a market question into a checkable workflow.

These recipes start with a real research task, show the request and point to the fields that matter. Each one ends with the limitation you should understand before using the answer.

01
Company data

Find meaningful insider buying

Are several executives buying their own shares?

Separate voluntary open-market purchases from vesting, gifts, option exercises, tax withholding and scheduled-plan noise.

Open the public ticker demo
Example request
GET /api/v1/insider-trades/AAPL?code=P&limit=100

Three-step workflow

  1. 1Request recent Form 4 transactions for the ticker.
  2. 2Check distinct buyers and the 30-day cluster flag.
  3. 3Read alert eligibility and the original SEC footnotes before acting.

Fields to inspect

summary.clusterBuy30Daystransactions[].alertEligibletransactions[].footnotes
Know the limitation

An insider purchase is context, not proof that the share price will rise. Footnotes remain the final authority.

02
Company data

Detect lowered company guidance

Has management reduced a forecast it previously filed?

Compare like-for-like management forecasts and keep the exact SEC-filed evidence behind every reported change.

Open the public ticker demo
Example request
GET /api/v1/guidance/NVDA?change=lowered&limit=20

Three-step workflow

  1. 1Filter the company history to lowered guidance.
  2. 2Compare the current and previous ranges using canonicalMetric.
  3. 3Open the source exhibit and read the quoted evidence in context.

Fields to inspect

guidance[].canonicalMetricguidance[].changeguidance[].evidence
Know the limitation

Guidance is voluntary. An empty result can be correct, and spoken-only earnings-call comments are outside this dataset.

03
Market intelligence

Audit stock sentiment on X

What is the bullish case, the bearish case and the evidence?

Read a balanced AI summary alongside the actual posts, sample size, translations and enrichment-quality status.

Example request
GET /api/sentiment?ticker=NVDA

Three-step workflow

  1. 1Request a current sentiment snapshot for the ticker.
  2. 2Compare the bull and bear summaries instead of relying on the score alone.
  3. 3Inspect the supporting posts and analysis status for weak or degraded evidence.

Fields to inspect

sentimentbullSummarybearSummarytopTweetsanalysis
Know the limitation

Social opinion is noisy and can be promotional. It describes the sampled conversation; it does not forecast price.

04
Signals & strategies

Review pre-breakout candidates

Which setups passed the structural filters, and why?

See the live pivot, distance, chart-quality checks and trader rationale instead of receiving a bare ticker list.

Example request
GET /api/radar?setup=breakout

Three-step workflow

  1. 1Read the board only after confirming the reported market regime.
  2. 2Review pivot distance, pattern checks, earnings and broke status.
  3. 3Use the explanation and chart evidence to decide whether the setup deserves research.

Fields to inspect

candidateFilterscandidates[].pivotcandidates[].patternMetricscandidates[].setupReasons
Know the limitation

A valid setup can fail, and strict filters can honestly return a short or empty list. Nothing here is an order or recommendation.

05
Market intelligence

Understand the news around a stock

What recent headlines matter, and how are they being framed?

Combine and deduplicate company coverage from several publishers, then retain links, source health and bull/bear context.

Example request
GET /api/news?ticker=AAPL

Three-step workflow

  1. 1Request recent company headlines from the combined source layer.
  2. 2Read the balanced summary and identify the concrete catalyst.
  3. 3Open the linked articles and check provider health before relying on the sample.

Fields to inspect

headlinesbullSummarybearSummaryproviderHealthfreshness
Know the limitation

Publisher coverage varies by ticker and time. Headline sentiment can miss details found only in the full article.

Need a different workflow?

Compare all datasets by the question they answer.

Browse the dataset catalog