Technical Overview

Request Enterprise Demo

Contact us at
enquiries@permutable.ai

Permutable’s structured news intelligence platform delivers institutional-grade market analysis for quantitative workflows. Our solution is designed for asset managers, hedge funds, and financial institutions seeking to integrate real-time news and event data into their trading and risk management systems. With a focus on transparency and actionable insights, the platform enables users to identify market-moving events, track sentiment, and monitor macroeconomic and geopolitical developments across global markets.

All



China



Metals
❮
❯

Implementation Use Cases

Full Coverage

Access broad and deep coverage across all major asset classes and geographies. Our platform captures:

Reaction around economic data releases
Events extending to extreme weather and geopolitics
Global and country datasets

Real-Time

Stay ahead with live hourly updates from our API, designed for systematic and quantitative workflows:

Live hourly updates from our API
Useful for systematic decision making

10 Year History

Unlock a decade of structured news intelligence for robust backtesting and research:

Systematic testing and strategy
Hourly data
Choose from 10,000’s of top source material

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

Retrieve a paginated list of financial asset events for a given ticker, ordered by date in descending order by default.
Supports date range filtering.

GET
/v1/events/financial/{ticker}/{ticker}

Parameters

Request Sample (Python)

Copy

import requests
# Replace with your actual credentials
API_KEY = "your-api-key"
# Headers
headers = {
    "x-api-key": API_KEY,
}
# Query parameters
params = {'start_date': '2024-11-25', 'end_date': '2024-11-25', 'limit': 10, 'offset': 0}
# Make the request
response = requests.get(
    "https://copilot-api.permutable.ai/1/events/fundamental/ticker/BZ_COM",
    headers=headers,
    params=params
)
# Check for errors
response.raise_for_status()
# Get the response data
data = response.json()
print(data)
                        

Responses

Response Type

application/json

Sample Response

// Structure: events is an array of event objects, each with asset, direction, event_date, headline, description, event_type, source_count, sources, impact, etc.

{
  "events": [
    {"asset": "Brent Crude Oil", "direction": "bullish", "event_date": "2025-05-17T08:43:59.837", "headline": "Ukraine-Russia conflict continues to escalate...", "description": "The escalation of the Ukraine-Russia conflict primarily affects geopolitical stability and may impact global grain markets, but it does not have a direct impact on Brent crude oil prices. Our regional analysts emphasize that the oil market is more affected by OPEC+ production decisions and global demand patterns.", "event_type": "geopolitical conflict", "source_count": 3, "sources": ["Reuters", "Bloomberg", "BBC"], "impact": 0.65 },
    {"asset": "Gold", "direction": "bearish", "event_date": "2025-05-16T14:30:00.000", "headline": "Gold prices continue to rise amid global economic uncertainty...", "description": "Gold prices continue to rise amid global economic uncertainty and geopolitical tensions.", "event_type": "market trends", "source_count": 3, "sources": ["Reuters", "CNBC", "Bloomberg"], "impact": 0.42 }
  ],
  "total": 26,
  "page": 1,
  "pages": 3
}
                            

API Documentation


Request Enterprise Demo

Sample Data

Select Asset:
All AssetsBrent Crude OilGoldLNGMicrosoft
Filter by Sentiment:
All SentimentsUpward (Bullish)Downward (Bearish)
Filter by Topic:
All Topics

Request Enterprise Demo