Energy Sentiment

Overview

Request Enterprise Demo

Permutable’s Energy Intelligence platform provides granular insights into the energy sector. We track key assets including crude oil (Brent, WTI), natural gas (TTF, Henry Hub), distillates, and LNG. Our system analyzes demand and supply factors, price reports, trade effects, and regional price impacts. We also identify new story breakouts, monitor ongoing coverage, and detect sentiment shifts related to energy news. Furthermore, our advanced story signal analysis identifies critical narrative developments such as: New Story Breakout – detects the initial emergence of a significant news narrative (crude_first_headline_detection); Story Volume Build Up – monitors increasing volume of discussion around a specific story (crude_story_modified_volume_increase); Story Direction Change – identifies shifts in the sentiment or focus of an evolving story (crude_story_modified_direction_change); and Forced Persistent Story – tracks narratives that maintain presence due to continuous external inputs or events (crude_story_persistent). These signals help you stay ahead of market-moving events.

Implementation Use Cases

Trends Across Energy Assets

Monitor real-time trends and data for key energy benchmarks and products across crude oil and natural gas.

Brent, WTI, TTF and Henry Hub
Distillates
LNG

Topic & Regional Factors

Delayer each effect effecting price movements. Analyse key fundamental supply and demend themes shifts as well as price report sentiment.

Demand and supply factors
Price reports, trade effects
Continent price effects

Story Signal

Identify impactful news narratives and sentiment shifts as they emerge through the following key signals:

New story breakout
Continued story buildup
Story direction shift

Permutable Co-Pilot API enables programmatic access to structured news data with millisecond latency and enterprise-grade reliability. Full documentation is available at
https://copilot-api.permutable.ai/redoc,
including Python, R, and Java client libraries with webhook support.

API Reference

Retrieves the latest live (hourly) sentiment data for a specific financial ticker, offering real-time insights into asset-specific mood.

GET
/v1/sentiment/live/ticker/{ticker}

Path Parameters

Query Parameters

Request Sample (Python)

Copy

import requests
# Replace with your actual API key and desired ticker
API_KEY = "your-api-key"
ENERGY_TICKER = "BZ_COM" # Example: Brent Crude
headers = {"x-api-key": API_KEY}
params = {
    "signal_type": "Combined", # Options: 'Combined', 'Asset', 'Macro', 'Sector'
    "sentiment_type": "topic"     # Options: 'topic', 'geolocation'
    # "version_id": "your_version_id" # Optional
}
response = requests.get(
    f"https://copilot-api.permutable.ai/v1/sentiment/live/ticker/{ENERGY_TICKER}",
    headers=headers,
    params=params
)
response.raise_for_status()
data = response.json()
print(data)

Responses

Response Example

{
  "sentiment": [
    {
      "ticker": "BZ_COM",
      "topic": "Supply-Geopolitical Tension",
      "event_type": "Combined",
      "date": "2024-01-01T00:00:00Z",
      "sentiment_index": 0.5
    }
    // ... more sentiment data objects might appear here if applicable ...
  ]
}

API Documentation

Sample Data (Fundamental Indices – Brent Crude)

Beyond fundamental indices, our API offers advanced Story Signal Analysis to help you track market-moving narratives. These event-driven alerts identify key shifts in news and discussions. Key signals include:

• New Story Breakout: Detects the initial emergence of a significant news narrative (e.g., crude_first_headline_detection).
• Story Volume Build-Up: Monitors increasing discussion around a specific story (e.g., crude_story_modified_volume_increase).
• Story Direction Change: Identifies shifts in the sentiment or focus of an evolving story (e.g., crude_story_modified_direction_change).
• Forced Persistent Story: Tracks narratives that maintain presence due to continuous external inputs or events (e.g., crude_story_persistent).

The table below shows an example of fundamental indices for an energy benchmark, illustrating the granular data available.