Skip to main content
POST
Create a thesis manually

Body

application/json

Request body for manually creating a thesis.

direction
enum<string>
required
Available options:
bullish,
bearish,
neutral
timeframe
enum<string>
required
Available options:
intraday,
swing,
position
narrative
string
required

1-2 sentence thesis

Required string length: 10 - 1000
sectors
string[]
required

Ranked by thesis fit

Required array length: 1 - 11 elements
catalysts
string[]
Maximum array length: 10
invalidation_conditions
string[]
Maximum array length: 10
catalyst_ids
string[]

Structured catalyst IDs from taxonomy

Maximum array length: 10
risk_ids
string[]

Structured risk IDs from taxonomy

Maximum array length: 10
confidence
number
default:0.5

Thesis conviction 0-1

Required range: 0 <= x <= 1
macro_event_id
string | null

Driving MacroEvent event_id

symbols
string[]

Symbols associated with this thesis

Maximum array length: 50

Response

Successful Response

Full thesis model for API responses.

thesis_id
string<uuid>
required
created_at
string<date-time>
required
status
enum<string>
required

Thesis lifecycle status.

Available options:
active,
invalidated,
expired,
realized
direction
enum<string>
required
Available options:
bullish,
bearish,
neutral
timeframe
enum<string>
required
Available options:
intraday,
swing,
position
narrative
string
required

1-2 sentence human-readable thesis

sectors
string[]
required

Ranked by thesis fit

confidence
number
required

Thesis-specific conviction 0-1

Required range: 0 <= x <= 1
source
enum<string>
required
Available options:
ai_generated,
user_defined,
debate_derived,
news_derived
valid_until
string<date-time>
required

Auto-set based on timeframe

regime_dominant
string | null

V5 dominant state at creation

regime_confidence
number | null

V5 Shannon entropy confidence (0-100)

regime_vector
Regime Vector · object | null

Full 6-state probabilities (for audit)

vix_regime
string | null

VIX regime label at creation

day_type
string | null

Day classification at creation

catalysts
string[]
invalidation_conditions
string[]
catalyst_ids
string[]

Structured catalyst IDs

risk_ids
string[]

Structured risk IDs

debate_id
string<uuid> | null
macro_event_id
string | null

Driving MacroEvent (graph event_id)

symbols
string[]
regime_drifted
boolean
default:false

True if current regime differs from thesis regime