Trading Co-Pilot: Energy Insights and Trends
Explore real-time energy market events, AI-powered sentiment analysis, and structured data for key energy assets like Brent, WTI, TTF, Henry Hub, Distillates, and LNG.
enquiries@permutable.aiOverview
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.
Topic & Regional Factors
Delayer each effect effecting price movements. Analyse key fundamental supply and demend themes shifts as well as price report sentiment.
Story Signal
Identify impactful news narratives and sentiment shifts as they emerge through the following key signals:
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
Name | Description |
---|---|
ticker
required
string
|
Ticker symbol to retrieve sentiment data for. |
Query Parameters
Name | Description |
---|---|
version_id string |
Version id to filter sentiment data. Defaults to latest production version. |
signal_type string Default: "Combined" |
Type of signal to use in the sentiment analysis. Options are 'Combined', 'Asset', 'Macro', 'Sector'. |
sentiment_type string Default: "topic" |
Type of sentiment to analyze. Options are 'topic' or 'geolocation'. |
Request Sample (Python)
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
Code | Description |
---|---|
200 | Successful Response |
403 | Forbidden: Either not authorized due to header or missing ticker permissions. |
404 | Not Found: No sentiment data found for the provided ticker. |
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 ... ] }
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.
Date/Time | Price Commentary | Demand | Supply | ||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Forecast | Review | Global Economic Conditions | Trade and Export Dynamics | Other | Geopolitical and Policy Developments | Trade Restrictions and Regulatory Changes | Pipelines, Refineries and Storage | Production Levels | Geopolitical Tensions | Inventory Levels |
Request Enterprise Demo
Please fill out the form below and we'll get back to you within 24 hours.