Signals via API

Public sample from today's flagship detail endpoint. Public payloads can be limited or redacted. The backend exposes read endpoints for signals, storylines, and briefings.

GET /v1/narratives/6f2a6205-5da8-4cf2-a606-79b29f0cdf6f?tenant=geopolitics&run_id=f2810d88-8485-42c4-9b19-30aee8255db1

{
  "id": "6f2a6205-5da8-4cf2-a606-79b29f0cdf6f",
  "title": "Splash Wrap: Hormuz at a standstill",
  "summary": "Traffic through the Strait of Hormuz came to a near standstill after US strikes on Iran, with president Donald Trump declaring the ceasefire between the two countries “over.” The escalation followed attacks on three commercial vessels transiting the strait on July 6 and 7. Ukraine has sharply escalated its campaign against Russian shipping and oil …",
  "first_seen_at": "2026-07-09T18:27:36Z",
  "last_seen_at": "2026-07-10T16:01:00Z",
  "created_at": "2026-07-10T17:18:55.923202Z",
  "updated_at": "2026-07-11T05:15:58.739577Z",
  "timeframe": "24h",
  "run_id": "f2810d88-8485-42c4-9b19-30aee8255db1",
  "metrics": {
    "divergence": 9.5126,
    "post_count": 5,
    "momentum_1h": 0,
    "momentum_7d": 5,
    "score_total": 1.60689,
    "shill_score": 6,
    "momentum_24h": 5,
    "market_movers": [],
    "evidence_score": 1,
    "unique_authors": 5,
    "coherence_score": 0.7852,
    "diversity_bonus": 0.2,
    "duplicate_ratio": 0,
    "platforms_count": 1,
    "social_momentum": 5,
    "divergence_label": "chatter_without_pricing",
    "market_conviction": 0,
    "origin_share_top1": 0.2,
    "unique_publishers": 5,
    "origin_layer_posts": 0,
    "source_types_count": 1,
    "unique_authors_24h": 5,
    "unique_origin_urls": 5,
    "amplifier_share_top1": 0.2,
    "author_concentration": 0.2,
    "publisher_share_top1": 0.2,
    "amplifier_layer_posts": 5,
    "concentration_penalty": 0,
    "unique_origin_domains": 5,
    "source_diversity_bonus": 0,
    "unique_publisher_types": 1,
    "unique_origin_publishers": 5
  },
  "platforms": [
    "rss"
  ],
  "top_tickers": [],
  "why_now": [],
  "display_title": "Renewed US-Iran conflict disrupts Strait of Hormuz shipping and lifts oil prices",
  "display_summary": "Renewed fighting between the US and Iran has brought shipping traffic through the Strait of Hormuz to a near halt, raising fears of supply disruptions.",
  "narrative_frame_display": null,
  "entities": {
    "tickers": [
      "Brent",
      "WTI"
    ],
    "people": [
      "Donald Trump"
    ]
  },
  "recurring_claims": [
    {
      "claim": "Renewed US-Iran fighting has brought shipping through the Strait of Hormuz to a near standstill.",
      "evidence_urls": [
        "https://aljazeera.com/economy/2026/7/10/strait-of-hormuz-shipping-grinds-to-halt-as-us-iran-resume-fighting?traffic_source=rss",
        "https://gcaptain.com/intertanko-southern-hormuz-transits-drop-to-single-digits-amid-renewed-gulf-escalation",
        "https://splash247.com/splash-wrap-hormuz-at-a-standstill"
      ]
    },
    {
      "claim": "Brent crude oil prices have risen above $76 per barrel due to renewed Middle East risks.",
      "evidence_urls": [
        "https://oilprice.com/Energy/Energy-General/Oils-Calm-Is-Over-as-Middle-East-Risks-Return.html",
        "https://oilprice.com/Latest-Energy-News/World-News/Oil-Prices-Set-for-Weekly-Gain-as-Hormuz-Tensions-Escalate.html",
        "https://oilprice.com/Energy/Energy-General/Oil-Prices-Rally-on-Renewed-Hormuz-Supply-Risks.html"
      ]
    },
    {
      "claim": "Marine insurers report increased war-risk cover costs as shipowners reduce transits through Hormuz.",
      "evidence_urls": [
        "https://gcaptain.com/hormuz-war-risk-cover-climbs-as-shipowners-pull-back"
      ]
    }
  ],
  "stance_map": [
    {
      "stance": "neutral",
      "who": "OilPrice.com",
      "evidence_urls": [
        "https://oilprice.com/Energy/Energy-General/Oils-Calm-Is-Over-as-Middle-East-Risks-Return.html"
      ]
    }
  ],
  "quality_flags": {
    "mixed_topic_risk": "low",
    "promo_risk": "low",
    "source_quality": "medium"
  },
  "editor_note": "This briefing highlights the direct impact of renewed US-Iran conflict on oil supply routes and market prices, relevant for energy and geopolitical risk monitoring.",
  "display_tags": [
    "energy",
    "geopolitics",
    "oil",
    "shipping",
    "middle_east"
  ],
  "tags": [
    "energy",
    "geopolitics",
    "oil",
    "shipping",
    "middle_east"
  ],
  "cscope_tags": [
    "energy",
    "geopolitics",
    "oil",
    "shipping",
    "middle_east"
  ],
  "why_now_display": [
    "Recent US strikes on Iran and retaliatory attacks have sharply reduced shipping traffic through Hormuz.",
    "Oil prices have responded quickly, with Brent crude rising above $76 per barrel this week.",
    "Market recovery depends on the stability of this key maritime route amid ongoing tensions."
  ],
  "why_it_matters_display": [
    "The Strait of Hormuz is a critical chokepoint for global oil supply; disruptions can cause price volatility.",
    "Renewed US-Iran hostilities increase geopolitical risk premiums, affecting energy markets worldwide.",
    "Rising war-risk insurance costs reflect heightened operational risks for shipping companies."
  ],
  "show_why": true,
  "sources_display": [
    {
      "label": "oilprice.com: OilPrice.com"
    },
    {
      "label": "gcaptain.com: gCaptain"
    },
    {
      "label": "gCaptain: Oil Market Recovery Hinges on Hormuz Stability as IEA Warns Renewed Fighting Clouds Outlook"
    },
    {
      "label": "OilPrice.com: Oil Prices Rally on Renewed Hormuz Supply Risks"
    },
    {
      "label": "gCaptain: More LNG, Japan-Linked Vessels Transit Hormuz Despite Renewed Mideast Tensions"
    }
  ],
  "trend_status": "flat",
  "trend_sparkline": "█▁",
  "trend_points_n": 0,
  "trend_window": {
    "lookback_days": 14,
    "max_points": 36,
    "value_key": null
  },
  "llm_status": "accepted",
  "llm_meta": {
    "model": "gpt-4.1-mini-2025-04-14",
    "prompt_version": "enrich_v3",
    "input_hash": "e4f681b6bb0ab03f6c27c026c1b538367b9548b4548503bb421241aac6f77868",
    "updated_at": "2026-07-10T17:21:48.951609+00:00",
    "llm_metadata": {
      "env": "prod",
      "host": "3becb33dec2d",
      "stage": "signals.enrich",
      "run_id": "f2810d88-8485-42c4-9b19-30aee8255db1",
      "tenant": "geopolitics",
      "service": "api",
      "pipeline": "pipeline_run",
      "correlation_id": "6f2a6205-5da8-4cf2-a606-79b29f0cdf6f"
    }
  },
  "story_id": "2a7f8419-e92f-41dc-815d-5e99fc83419a",
  "public_surface": {
    "eligible_for_flagship_sample": true,
    "eligible_for_top_public_brief": true,
    "eligible_for_public_index": false,
    "eligible_only_for_lower_or_internal_surfaces": false,
    "public_rank_score": 12,
    "structural_priority": true,
    "mostly_social": false,
    "community_chatter": false,
    "reader_label": null,
    "excluded_reasons": [],
    "source_signals": {
      "post_count": 5,
      "unique_origins": 5,
      "source_types_count": 1,
      "independent_non_social_count": 5,
      "social_source_count": 0,
      "non_social_source_count": 0,
      "why_now_count": 3,
      "why_it_matters_count": 3
    }
  },
  "current_cycle_open": false
}

• Signals and storylines feed endpoints with filtering and rate limits
• Briefing delivery endpoints for integrations
• Evidence link payloads for auditability

• Route top stories into Slack or Teams for morning and evening desk updates.
• Sync storyline evidence into Notion, Airtable, or internal research trackers.
• Feed metrics into BI dashboards for momentum, concentration, and source mix monitoring.

Quick start endpoints: /v1/feed/stories, /v1/signals, /v1/storylines/search, /v1/briefings/latest.

For product access, see Pricing.