Get complete stock context

curl --request GET \
  --url https://api.example.com/api/graph/v1/stocks/{symbol}

const options = {method: 'GET'};

fetch('https://api.example.com/api/graph/v1/stocks/{symbol}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.example.com/api/graph/v1/stocks/{symbol}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/api/graph/v1/stocks/{symbol}"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.example.com/api/graph/v1/stocks/{symbol}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "adv20_usd": 8000000000,
  "adv30_usd": 7500000000,
  "dollar_volume": 8000000000,
  "dollar_volume_today": 8797500000,
  "last_price": 195.5,
  "rel_volume": 1.17,
  "symbol": "AAPL",
  "technical": {
    "rsi_14": 55.2,
    "trend_stack_valid": true
  },
  "updated_at": "2025-12-20T15:30:00Z",
  "volume": 45000000
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "input": "<unknown>",
      "ctx": {}
    }
  ]
}

Stocks

Get complete stock context

Get full stock context with all relationships for a specific symbol. ## Query Parameters - **date**: Trade date in YYYY-MM-DD format (default: today) - **include**: Comma-separated list of includes: - `levels`: IntradayLevel data (pivots, IB, CPR, value area) - `volume_profile`: VolumeProfileSession (prior + developing) - `patterns`: Active technical patterns - `news`: News event summary - `strategies`: Strategy match recommendations - `confluence_components`: Structured v4.5 component breakdown (8 components with weights, scores, notes) - `level_ladder`: Sorted level ladder with ATR distances and confluence zones ## Response Complete StockResult with all available metrics and requested includes. ## Performance Target <100ms for single stock without includes, <300ms with includes.

GET

api

graph

stocks

{symbol}

Get complete stock context

curl --request GET \
  --url https://api.example.com/api/graph/v1/stocks/{symbol}

const options = {method: 'GET'};

fetch('https://api.example.com/api/graph/v1/stocks/{symbol}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.example.com/api/graph/v1/stocks/{symbol}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/api/graph/v1/stocks/{symbol}"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.example.com/api/graph/v1/stocks/{symbol}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "adv20_usd": 8000000000,
  "adv30_usd": 7500000000,
  "dollar_volume": 8000000000,
  "dollar_volume_today": 8797500000,
  "last_price": 195.5,
  "rel_volume": 1.17,
  "symbol": "AAPL",
  "technical": {
    "rsi_14": 55.2,
    "trend_stack_valid": true
  },
  "updated_at": "2025-12-20T15:30:00Z",
  "volume": 45000000
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "input": "<unknown>",
      "ctx": {}
    }
  ]
}

Path Parameters

symbol

string

required

Query Parameters

date

string | null

Trade date (YYYY-MM-DD), defaults to today

Pattern: ^\d{4}-\d{2}-\d{2}$

include

string | null

Comma-separated includes: levels,patterns,news,volume_profile,strategies,confluence_components,level_ladder,thematic_exposure

Response

Stock details

Complete stock data with all available metrics.

This is the primary response model for stock queries.

symbol

string

required

Stock ticker symbol

volume

integer

required

Required range: x >= 0

dollar_volume

number

required

DEPRECATED: Use adv20_usd (20-day avg) or dollar_volume_today. Currently stores 20-day average.

Required range: x >= 0

updated_at

string<date-time>

required

company_name

string | null

Company name (e.g. NVIDIA Corporation)

company_description

string | null

Company description

ceo

string | null

CEO name

headquarters

string | null

Headquarters location

employees

integer | null

Number of full-time employees

ipo_date

string | null

IPO date

website

string | null

Company website URL

logo_url

string | null

Company logo URL

last_price

number | null

Last price. Delayed (>= 15m old) for non-realtime_sip callers; the live scalar is suppressed to null when no delayed bar is available (see source).

Required range: x >= 0

source

string

default:realtime_sip

Market-data feed source label (entitlement layer): 'realtime_sip' | 'delayed' | 'byok'. Non-realtime_sip callers get 'delayed'.

dollar_volume_today

number | null

Today's dollar volume (last_price × volume)

Required range: x >= 0

adv20_usd

number | null

20-day average dollar volume (canonical name for what was misleadingly called dollar_volume)

Required range: x >= 0

adv30_usd

number | null

30-day average dollar volume

Required range: x >= 0

adv30_shares

integer | null

30-day average daily share volume (for liquidity hard gate: >= 500k)

Required range: x >= 0

rel_volume

number | null

Relative volume: yesterday's volume / 20-day average daily volume

Required range: x >= 0

rel_vol_5d

number | null

5-day average volume / 20-day average volume (volume trend)

Required range: x >= 0

volume_trend

enum<string> | null

Available options:

increasing,

decreasing,

stable

technical

Technical · object | null

Technical indicator values.

Show child attributes

compression

Compression · object | null

Volatility compression indicators.

Show child attributes

options

Options · object | null

Options-related data.

Note: Data availability depends on options-collector pipeline status.

Show child attributes

fundamental

Fundamental · object | null

Fundamental data.

Most fields are written by the Go graph writer from Yahoo Finance fundamentals collector. market_cap, sector, exchange are core identifiers.

Show child attributes

day_context

DayContext · object | null

Daily classification context.

Show child attributes

earnings

Earnings · object | null

Earnings-related data including surprise metrics.

Note: Data availability depends on earnings-sync pipeline status.

Show child attributes

range_3d

Range3D · object | null

3-day range breakout tracking.

Show child attributes

analyst

Analyst · object | null

Analyst consensus, estimates, and rating data from FMP (COR-68/69).

Show child attributes

ownership

Ownership · object | null

Insider and institutional ownership data from FMP (COR-68/69).

Show child attributes

levels

Levels · object | null

Key price levels from IntradayLevel vertex.

Show child attributes

volume_profile

VolumeProfile · object | null

Volume profile data from VolumeProfileSession vertex.

Show child attributes

patterns

Pattern · object[] | null

Show child attributes

news

News · object | null

News summary aggregated from news_sentiment table.

Show child attributes

price_events

PriceEvent · object[] | null

Recent price events (gaps, breakouts, MA crossovers, volume events). Populated via include option.

Show child attributes

confluence_components

ConfluenceComponentBreakdown · object | null

Structured breakdown of 8 v4.5 confluence components with weights and notes. Populated via include option.

Show child attributes

level_ladder

LevelLadder · object | null

Sorted level ladder with ATR distances and confluence zones. Populated via include option.

Show child attributes

price

SessionPriceData · object | null

Session-specific price data with pre-market, regular, and after-hours OHLC

Show child attributes

Example:

{
  "ask": 195.52,
  "ask_size": 150,
  "bid": 195.48,
  "bid_size": 200,
  "change": 2.3,
  "change_percent": 1.19,
  "current": 195.5,
  "last_update": "2025-01-06T14:30:45Z",
  "market_status": "open",
  "pre_market": {
    "close": 194.6,
    "high": 194.8,
    "last": 194.65,
    "low": 193.25,
    "open": 193.5
  },
  "previous_close": 193.2,
  "regular_session": {
    "close": 195.48,
    "high": 196,
    "last": 195.5,
    "low": 194.5,
    "open": 194.7
  }
}

confluence_score

number | null

Confluence score v3 (0-100): weighted combination of volume, technical, day type, pattern, and proximity scores

Required range: 0 <= x <= 100

confluence_tier

string | null

Tier derived from confluence_score: EXCELLENT (>=90), GOOD (>=80), MODERATE (>=70), WEAK (>=60), POOR (<60)

bullish_confluence

number | null

Canonical bullish confluence (0-100): v5 scoring

Required range: 0 <= x <= 100

bearish_confluence

number | null

Canonical bearish confluence (0-100): v5 scoring

Required range: 0 <= x <= 100

bullish_tier

string | null

Tier from bullish_confluence: EXCELLENT (>=85), GOOD (>=70), MODERATE (>=50), WEAK (>=25), POOR (<25)

bearish_tier

string | null

Tier from bearish_confluence: EXCELLENT (>=85), GOOD (>=70), MODERATE (>=50), WEAK (>=25), POOR (<25)

net_confluence

number | null

Canonical net confluence (-100 to +100): bullish_confluence - bearish_confluence

Required range: -100 <= x <= 100

directional_bias

string | null

Canonical directional bias from net_confluence thresholds

scoring_version

string | null

Canonical confluence scoring version source (v5 preferred)

conviction_max_v5

number | null

max(bull, bear) — conviction regardless of direction (0-100)

Required range: 0 <= x <= 100

conflict_min_v5

number | null

min(bull, bear) — disagreement signal (0-100)

Required range: 0 <= x <= 100

directional_bias_v5

string | null

BULL_DOMINANT / BEAR_DOMINANT / MIXED (10pt margin)

is_overextended

boolean

default:false

True if price is >2 ATR from SMA20 (exhaustion risk for bulls)

is_distribution

boolean

default:false

True if elevated volume with declining trend (bearish signal)

nearest_level_type

string | null

Classification of nearest level: 'support', 'resistance', or 'neutral'

cvd

number | null

Cumulative Volume Delta (raw shares, positive=buying, negative=selling)

cvd_pct

number | null

CVD as % of total session volume (normalized, cross-symbol comparable)

cvd_divergence

string | null

CVD vs price divergence: bullish_div, bearish_div, none

cvd_trend

string | null

CVD trend: accumulating, distributing, neutral

bullish_entry_score

number | null

Bullish entry score 0-100 (intraday timing)

bearish_entry_score

number | null

Bearish entry score 0-100 (intraday timing)

net_entry_score

number | null

Net entry score (-100 to +100): bullish - bearish

entry_score_completeness

number | null

Entry score completeness 0.0-1.0 (how many components available)

entry_gates_passed

boolean | null

Whether all entry quality gates passed

entry_failed_gates

string[] | null

List of failed entry quality gate names

entry_gex_modifier

string | null

GEX regime modifier applied: long_gamma, short_gamma, or empty

gex_regime

string | null

Current GEX regime: long_gamma, short_gamma, or neutral

gex_gamma_flip

number | null

Strike price where dealer gamma flips sign

momentum_trend_bull

number | null

V4.2 momentum component bullish score (0-10). Positive momentum favors bulls.

Required range: 0 <= x <= 10

momentum_trend_bear

number | null

V4.2 momentum component bearish score (0-10). Negative momentum favors bears.

Required range: 0 <= x <= 10

momentum_blend

number | null

Blended multi-horizon return: 0.5ret_60d + 0.3ret_90d + 0.2*ret_20d (percentage)

momentum_slope_60d

number | null

Linear regression slope of log(close) over 60 days (annualized percentage)

proximity_bull

number | null

proximity_bear

number | null

volatility_bull

number | null

volatility_bear

number | null

volume_bull

number | null

volume_bear

number | null

pattern_bull

number | null

pattern_bear

number | null

iv_bull

number | null

iv_bear

number | null

day_type_bull

number | null

day_type_bear

number | null

vix_regime_bull

number | null

vix_regime_bear

number | null

event_proximity_bull

number | null

event_proximity_bear

number | null

beta_gate_passed

boolean | null

True if stock passes beta risk gate (VIX-aware: max 1.5 in EXTREME_FEAR, 2.0 in ELEVATED)

beta_gate_reason

string | null

Explanation for beta gate result

fundamental_gate_passed

boolean | null

True if stock passes fundamental quality gate (quality score >= 50)

fundamental_quality_score

integer | null

Fundamental quality score (0-100) based on P/E, ROE, and profit margin

Required range: 0 <= x <= 100

fundamental_grade

string | null

Fundamental health grade A-F based on growth, margins, leverage, earnings execution, and sentiment

fundamental_health_score

integer | null

Fundamental health score (0-100) underlying the A-F grade

Required range: 0 <= x <= 100

earnings_sentiment_bias

string | null

Earnings sentiment from surprise %: POSITIVE (>10%), SLIGHT_POSITIVE (0-10%), SLIGHT_NEGATIVE (-10-0%), NEGATIVE (<-10%)

all_quality_gates_passed

boolean | null

True if all quality gates (beta, fundamental, earnings sentiment) passed

pricing_edge_bull

number | null

Pricing edge bullish score from binomial pricer (0-10)

Required range: 0 <= x <= 10

pricing_edge_bear

number | null

Pricing edge bearish score (0-10)

Required range: 0 <= x <= 10

greek_alignment_bull

number | null

Greek alignment bullish score based on VIX regime (0-10)

Required range: 0 <= x <= 10

greek_alignment_bear

number | null

Greek alignment bearish score (0-10)

Required range: 0 <= x <= 10

orb_structure_bull

number | null

ORB structure bullish score (trap/breakout patterns, 0-10)

Required range: 0 <= x <= 10

orb_structure_bear

number | null

ORB structure bearish score (0-10)

Required range: 0 <= x <= 10

orb_proximity_bull

number | null

ORB proximity bullish score (0-10)

Required range: 0 <= x <= 10

orb_proximity_bear

number | null

ORB proximity bearish score (0-10)

Required range: 0 <= x <= 10

v44_intraday_circuit_breaker_gate_passed

boolean | null

True if intraday circuit breaker gate passed (no severe decline)

intraday_return_pct

number | null

Intraday return percentage: (last_price - pdc) / pdc * 100

intraday_return_bull

number | null

Intraday return bullish component score (0-10)

Required range: 0 <= x <= 10

intraday_return_bear

number | null

Intraday return bearish component score (0-10)

Required range: 0 <= x <= 10

extreme_rsi_warning

boolean

default:false

True when RSI < 15 or RSI > 85 (extreme territory)

confluence_computed_at

string<date-time> | null

Timestamp when confluence scores were last computed (for staleness detection)

score_warnings

string[]

Active score warnings. Open-set vocabulary — consumers MUST default to pass-through on unknown values. Current known values: intraday_decline_severe, extreme_rsi, circuit_breaker_active, score_stale, conviction_stale. See app/documentation/ontology/SCORING_REGISTRY.md § Scoring Version Precedence.

pulse_bull

number | null

Pulse bullish score (0-100): real-time intraday conviction

Required range: 0 <= x <= 100

pulse_bear

number | null

Pulse bearish score (0-100): real-time intraday conviction

Required range: 0 <= x <= 100

pulse_net

number | null

Pulse net score (-100 to +100): pulse_bull - pulse_bear

Required range: -100 <= x <= 100

pulse_bias

string | null

Pulse directional bias: STRONG_LONG/MOD_LONG/NEUTRAL/MOD_SHORT/STRONG_SHORT

pulse_computed_at

string<date-time> | null

Timestamp when pulse scores were last computed (for staleness detection)

entry_score_computed_at

string<date-time> | null

Timestamp when entry scores were last computed (for staleness detection)

orb_directional_bias

string | null

ORB directional bias: bullish|bearish|neutral

dark_pool_pct_1d

number | null

Session dark pool volume percentage (0-1)

block_trade_count

integer | null

Number of block trades detected today

buy_sell_ratio

number | null

Buy/sell volume ratio (Lee-Ready tick rule)

net_buy_volume

integer | null

Net buy volume (buy - sell)

dark_volume_1d

integer | null

Total dark pool volume today

lit_volume_1d

integer | null

Total lit exchange volume today

regime_v5

RegimeV5 · object | null

V5 regime state vector (shadow mode).

Show child attributes

confluence_v5

ConfluenceV5 · object | null

V5 confluence scoring with regime-conditioned weights (shadow mode).

Show child attributes

momentum_health_v5

MomentumHealthV5 · object | null

V5 momentum health 4-axis composite (shadow mode).

Show child attributes

conviction_v5

ConvictionV5 · object | null

Conviction meta-score (MSE real-time).

Show child attributes

conviction_v5_session_open

number | null

conviction_v5_lookback

number | null

conviction_v5_lookback_minutes

integer | null

conviction_v5_velocity

number | null

conviction_v5_stability

number | null

conviction_v5_direction_minutes

integer | null

conviction_v5_direction_flip

boolean | null

conviction_v5_delta_valid

boolean | null

pulse_v5

PulseV5 · object | null

Pulse v5 real-time momentum.

Show child attributes

entry_v2

EntryV2 · object | null

Entry Score v2 execution timing.

Show child attributes

peer_divergence_v1

PeerDivergenceV1 · object | null

Peer divergence via graph diffusion (heat kernel on multi-layer adjacency).

Show child attributes

thematic_exposures

ThematicExposure · object[] | null

Structural theme exposures with direction, magnitude, and momentum

Show child attributes

halted

boolean

default:false

quote_timestamp

string<date-time> | null

Timestamp of latest quote data (SLA: < 5 seconds)

bar_1min_timestamp

string<date-time> | null

Timestamp of latest 1-minute bar (SLA: < 5 minutes)

bar_daily_timestamp

string<date-time> | null

Timestamp of latest daily bar (SLA: < 4 hours during market)

Start

Operating

API

API reference

Runbooks

Get complete stock context

Path Parameters

Query Parameters

Response