Skip to main content
Gildea classifies every signal into a two-axis theme system. Signals can have multiple themes per axis.

​
Value chain (value_chain)

Where in the AI value chain does this signal sit?
ThemeDescription
InfrastructureThe compute layer — GPUs, TPUs, custom chips, and cloud infrastructure that make large-scale model training and inference possible.
Foundation ModelsThe core models that define capability — trained systems like GPT, Claude, Gemini, and Llama that serve as the base for downstream products.
OrchestrationThe software layer that makes models usable — frameworks, agents, vector stores, and developer tools for building and managing model-powered systems.
Data & LabelingThe data layer — how models are trained, evaluated, and refined, from raw datasets to synthetic data and human feedback loops.
ApplicationsThe product layer — AI features and experiences built for real users, from enterprise copilots to consumer agents.
DistributionThe delivery layer — how AI capabilities reach users, through APIs, platforms, partnerships, and ecosystems.

​
Market force (market_force)

What external pressure or catalyst is shaping the value chain?
ThemeDescription
Capital & InvestmentTracks the allocation of financial resources — who’s funding whom, how capital moves across stages, and how valuations shape incentives.
Regulatory & LegalTracks how rules, policies, and court decisions set the boundaries for innovation and competition.
Competitive DynamicsExamines how firms position themselves — via product strategy, data moats, or market timing — to gain or defend share.
Talent & LaborFollows the human factor — hiring trends, executive shifts, skill shortages, and how automation reshapes work.
Geopolitical StrategyAnalyzes the interplay between national interests, technology policy, and access to compute and talent.
Trust & Societal ImpactCaptures public sentiment, safety debates, and the ethics shaping adoption and regulation.

​
Interpretation fields

Each theme includes interpretation fields derived from the raw trend stats. These are discrete labels that agents can act on without statistical expertise.
FieldValuesWhat it tells you
directionRising, Stable, DecliningWhich way is this theme trending
confidenceSignificant, InsignificantIs the trend statistically reliable
stabilityVolatile, SteadyHow consistent is coverage week to week
priorityHigh, Medium, Low, NegligibleCombined assessment across all dimensions
priority_reasoningFree textHuman-readable explanation of the priority assignment
Themes do not have a scale field — all 12 themes are always active. 
{
  "axis": "value_chain",
  "label": "Foundation Models",
  "direction": "Rising",
  "confidence": "Significant",
  "stability": "Steady",
  "priority": "High",
  "priority_reasoning": "Theme with significant and steady upward trend; reliable signal of a narrative gaining sustained traction.",
  "trend": { "..." : "..." }
}

​
Theme intelligence

Each theme has a rich profile including:
  • Signal count — total signals tagged with this theme
  • Trend stats — analytics across four dimensions (see below)
  • Related themes — themes that frequently co-occur across both axes

​
Trend analytics

Every theme includes a trend object with analytics across four dimensions:
FieldDimensionDescription
share_of_voiceScaleTheme’s share of total corpus this week
theil_sen_slopeDirectionalityRobust trend slope (resistant to outliers)
streakDirectionalityConsecutive weeks of growth
chi2_trendSignificanceChi-square test statistic for linear trend
chi2_p_valueSignificanceStatistical significance of trend (< 0.05 = significant)
effect_sizeSignificanceCramer’s V — practical significance (0 = no effect, 1 = maximal)
coefficient_of_variationVolatilityHow variable is coverage (stddev / mean)

​
Using themes as filters

Themes work as filters across the API. Use the exact theme labels above: 
# Signals about Infrastructure
curl -H "X-API-Key: gld_your_key" \
  "https://api.gildea.ai/v1/signals?theme=Infrastructure"

# Entities in the Foundation Models space
curl -H "X-API-Key: gld_your_key" \
  "https://api.gildea.ai/v1/entities?theme=Foundation%20Models"

# Search within a theme
curl -H "X-API-Key: gld_your_key" \
  "https://api.gildea.ai/v1/search?q=chip+shortage&theme=Competitive%20Dynamics"

​
Theme detail

The theme detail endpoint returns co-occurring themes from both axes: 
{
  "axis": "value_chain",
  "label": "Foundation Models",
  "signal_count": 45,
  "trend": { "share_of_voice": 0.22, "theil_sen_slope": 0.12, "chi2_trend": 15.3, "..." : "..." },
  "related_themes": [
    {
      "axis": "market_force",
      "label": "Capital & Investment",
      "co_occurrence_count": 32
    }
  ]
}