Feed API

Signals via API

Feed API access for integrations is available under Business plans. Public endpoints show a limited or redacted payload; Pro is for individual app access.

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.

Public flagship sample

GET /v1/narratives/f3523981-68db-4a7d-bcda-c883f7f374a7?tenant=crypto&run_id=eafffd79-09f6-48e2-aa73-ff60093159cf

{
  "id": "f3523981-68db-4a7d-bcda-c883f7f374a7",
  "title": "Iran Wants Bitcoin Payments From Oil Ships Seeking Hormuz Passage: FT",
  "summary": "Iranian officials said Bitcoin payments would ensure the tolls “can’t be traced or confiscated due to sanctions.”",
  "first_seen_at": "2026-04-08T13:14:44Z",
  "last_seen_at": "2026-04-09T02:44:36Z",
  "created_at": "2026-04-08T17:00:21.169676Z",
  "updated_at": "2026-04-09T05:00:34.171688Z",
  "timeframe": "24h",
  "run_id": "eafffd79-09f6-48e2-aa73-ff60093159cf",
  "metrics": {
    "divergence": 29.0966,
    "post_count": 14,
    "momentum_1h": 0,
    "momentum_7d": 14,
    "score_total": 2.716426,
    "shill_score": 2.14,
    "momentum_24h": 14,
    "market_movers": [],
    "evidence_score": 1,
    "unique_authors": 14,
    "coherence_score": 0.7778,
    "diversity_bonus": 0.25,
    "duplicate_ratio": 0.2143,
    "platforms_count": 3,
    "social_momentum": 14,
    "divergence_label": "chatter_without_pricing",
    "market_conviction": 0,
    "origin_share_top1": 0.142857,
    "unique_publishers": 10,
    "origin_layer_posts": 0,
    "source_types_count": 3,
    "unique_authors_24h": 14,
    "unique_origin_urls": 13,
    "amplifier_share_top1": 0.357143,
    "author_concentration": 0.0714,
    "publisher_share_top1": 0.357143,
    "amplifier_layer_posts": 14,
    "concentration_penalty": 0,
    "unique_origin_domains": 11,
    "source_diversity_bonus": 0.4,
    "unique_publisher_types": 2,
    "unique_origin_publishers": 11
  },
  "platforms": [
    "reddit",
    "rss",
    "telegram"
  ],
  "top_tickers": [],
  "why_now": [],
  "display_title": "Iran to charge bitcoin tolls on oil tankers passing through Strait of Hormuz during ceasefire",
  "display_summary": "During a two-week ceasefire with the US, Iran plans to require oil tankers transiting the Strait of Hormuz to pay a $1 per barrel toll in bitcoin. This measure aims to bypass sanctions and traditional financial systems, ensuring payments cannot be traced or confiscated.",
  "narrative_frame_display": null,
  "entities": {
    "projects": [
      "Bitcoin"
    ],
    "people": [
      "Donald Trump"
    ]
  },
  "recurring_claims": [
    {
      "claim": "Iran plans to charge oil tankers $1 per barrel in bitcoin to transit the Strait of Hormuz during a two-week ceasefire.",
      "evidence_urls": [
        "https://coindesk.com/markets/2026/04/08/iran-eyes-crypto-toll-for-oil-tanker-transit-through-strait-of-hormuz",
        "https://crypto.news/iran-turns-strait-of-hormuz-into-1-per-barrel-bitcoin-tollbooth",
        "https://cointelegraph.com/news/iran-crypto-ships-strait-hormuz"
      ]
    },
    {
      "claim": "Bitcoin payments are intended to bypass sanctions and prevent toll payments from being traced or confiscated.",
      "evidence_urls": [
        "https://decrypt.co/363641/iran-bitcoin-payments-oil-ships-seeking-hormuz-passage",
        "https://ft.com/content/02aefac4-ea62-48db-9326-c0da373b11b8?syn-25a6b1a6=1",
        "https://bitcoinmagazine.com/news/iran-to-accept-bitcoin-for-strait"
      ]
    },
    {
      "claim": "Iran could earn around 282 BTC daily from the bitcoin tolls on oil tankers passing through the Strait of Hormuz.",
      "evidence_urls": [
        "https://ourcryptotalk.com/news/iran-bitcoin-strait-of-hormuz-oil-toll",
        "https://ft.com/content/02aefac4-ea62-48db-9326-c0da373b11b8?syn-25a6b1a6=1"
      ]
    }
  ],
  "stance_map": [
    {
      "stance": "neutral",
      "who": "Iranian officials",
      "evidence_urls": [
        "https://decrypt.co/363641/iran-bitcoin-payments-oil-ships-seeking-hormuz-passage",
        "https://ft.com/content/02aefac4-ea62-48db-9326-c0da373b11b8?syn-25a6b1a6=1"
      ]
    }
  ],
  "quality_flags": {
    "mixed_topic_risk": "low",
    "promo_risk": "low",
    "source_quality": "high"
  },
  "editor_note": null,
  "display_tags": [
    "crypto_assets",
    "regulation",
    "geopolitics"
  ],
  "tags": [
    "crypto_assets",
    "regulation",
    "geopolitics"
  ],
  "cscope_tags": [
    "crypto_assets",
    "regulation",
    "geopolitics"
  ],
  "why_now_display": [
    "Coincides with a two-week ceasefire between Iran and the US, enabling new transit arrangements.",
    "Sanctions limit Iran's access to traditional financial systems, prompting crypto adoption.",
    "The Strait of Hormuz remains a vital chokepoint for global oil flows, amplifying the impact of this policy."
  ],
  "why_it_matters_display": [
    "Highlights bitcoin's growing role in circumventing sanctions and geopolitical conflicts.",
    "Demonstrates innovative use of crypto payments in global energy trade and maritime transit.",
    "Signals potential shifts in how critical infrastructure tolls are collected amid geopolitical tensions."
  ],
  "show_why": true,
  "sources_display": [
    {
      "label": "ft.com: Financial Times exclusive on Iran's crypto tolls during ceasefire (via Reddit)"
    },
    {
      "label": "Cointelegraph: Iran is weighing crypto tolls for ships using Strait of Hormuz: Report"
    },
    {
      "label": "Iran To Earn 282 BTC Per Day From Straight Of Hormuz Toll: More Than 50% Of The Supply (via Reddit)"
    },
    {
      "label": "coinedition.com: Iran Eyes Bitcoin Toll for Strait of Hormuz Oil Transit (via Reddit)"
    },
    {
      "label": "Crypto.News: Iran wants to turn the Strait of Hormuz into a $1-per-barrel Bitcoin tollbooth"
    }
  ],
  "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": "9991c2da02c07cf26fb78f10a4d20200eecf4c147a5d1874a5c999f805249326",
    "updated_at": "2026-04-10T05:06:26.548261+00:00",
    "llm_metadata": {
      "env": "prod",
      "host": "34aa513340fd",
      "stage": "signals.enrich",
      "run_id": "f4c26688-24eb-411d-9e04-b2ae4764fb5c",
      "tenant": "crypto",
      "service": "api",
      "pipeline": "pipeline_run",
      "correlation_id": "f3523981-68db-4a7d-bcda-c883f7f374a7"
    }
  },
  "story_id": "0cb59fc1-5f10-4e3c-a1d2-ce86e2d7df8a",
  "public_surface": {
    "eligible_for_flagship_sample": true,
    "eligible_for_top_public_brief": true,
    "eligible_for_public_index": true,
    "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": 14,
      "unique_origins": 11,
      "source_types_count": 3,
      "independent_non_social_count": 11,
      "social_source_count": 0,
      "non_social_source_count": 0,
      "why_now_count": 3,
      "why_it_matters_count": 3
    }
  },
  "current_cycle_open": false
}
Capabilities
  • Signals and storylines feed endpoints with filtering and rate limits
  • Briefing delivery endpoints for integrations
  • Evidence link payloads for auditability
Integrate in your workflow
  • 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.