Narrative detail
curl --request GET \
--url https://astreus.ai/api/v1/intelligence/narratives/{id} \
--header 'X-API-KEY: <api-key>'import requests
url = "https://astreus.ai/api/v1/intelligence/narratives/{id}"
headers = {"X-API-KEY": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-KEY': '<api-key>'}};
fetch('https://astreus.ai/api/v1/intelligence/narratives/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://astreus.ai/api/v1/intelligence/narratives/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-KEY: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://astreus.ai/api/v1/intelligence/narratives/{id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-KEY", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://astreus.ai/api/v1/intelligence/narratives/{id}")
.header("X-API-KEY", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://astreus.ai/api/v1/intelligence/narratives/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-KEY"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"narrativeId": 10021258,
"name": "Regional geopolitical and supply chain disruption affecting project execution",
"description": "Operating environment complexity in 2026 driven by regional geopolitical developments combined with ongoing supply chain disruption, creating execution challenges and uncertainty for project-based bus…",
"status": "active",
"asOf": "2026-10-06",
"lifecycleState": "accelerating",
"breadth": 15,
"sectorCount": 5,
"firstObserved": "2022-11-03",
"lastObserved": "2026-09-22",
"memberObservations": 23,
"netDirection": 0.3157894736842105,
"forwardShare": 0.08695652173913043,
"metrics": [
{
"date": "2022-12-31",
"volume": 1,
"volume28d": 1,
"velocity": 1,
"acceleration": 1,
"breadth": 1,
"netDirection": 1,
"forwardShare": 0,
"lifecycleState": "emerging"
},
{
"date": "2023-03-31",
"volume": 0,
"volume28d": 0,
"velocity": -1,
"acceleration": -2,
"breadth": 1,
"netDirection": null,
"forwardShare": null,
"lifecycleState": "emerging"
}
],
"members": [
{
"cik": "XSAU000096",
"ticker": "2082",
"companyName": "ACWA Power Company",
"sector": "Utilities",
"joinedAt": "2022-11-03",
"lastObserved": "2023-11-02",
"observationCount": 2,
"netDirection": 0.5,
"divergent": false,
"latestQuote": {
"observationId": 0,
"quote": "At the same time, we know all the context that we believe in high interest rates, inflation, which is subsidizing in some parts, but in some past remains acute particularly when we go to EPC contracts…",
"statement": "Operating environment characterized by high interest rates, persistent inflation in EPC contracts, and ongoing supply chain disruptions from COVID and Russia-Ukraine geopolitical tensions",
"speakerName": "Marco Arcelli",
"speakerRole": "executive",
"ticker": "2082",
"cik": "XSAU000096",
"companyName": "ACWA Power Company",
"observedAt": "2023-11-02",
"observationType": "current_assessment",
"direction": null,
"verificationStatus": "supported",
"documentId": 36104,
"transcriptExternalId": "103809",
"transcriptDate": "2023-11-02",
"fiscalLabel": "Q3 FY2023",
"docType": "earnings_transcript",
"sourceSpan": {
"start": 7983,
"end": 8455
},
"relation": "supports",
"evidenceRole": "direct_development"
},
"quotes": [
{
"observationId": 0,
"quote": "At the same time, we know all the context that we believe in high interest rates, inflation, which is subsidizing in some parts, but in some past remains acute particularly when we go to EPC contracts…",
"statement": "Operating environment characterized by high interest rates, persistent inflation in EPC contracts, and ongoing supply chain disruptions from COVID and Russia-Ukraine geopolitical tensions",
"speakerName": "Marco Arcelli",
"speakerRole": "executive",
"ticker": "2082",
"cik": "XSAU000096",
"companyName": "ACWA Power Company",
"observedAt": "2023-11-02",
"observationType": "current_assessment",
"direction": null,
"verificationStatus": "supported",
"documentId": 36104,
"transcriptExternalId": "103809",
"transcriptDate": "2023-11-02",
"fiscalLabel": "Q3 FY2023",
"docType": "earnings_transcript",
"sourceSpan": {
"start": 7983,
"end": 8455
},
"relation": "supports",
"evidenceRole": "direct_development"
},
{
"observationId": 0,
"quote": "But realistically, and as you all know, within the framework of sort of unprecedented global geopolitical tensions and significant economic stresses, which are -- there is no end in sight and which ar…",
"statement": "Operating in persistent higher cost and interest rate environment with no end in sight, exacerbated by geopolitical tensions, economic stresses, and supply-demand imbalances from war.",
"speakerName": "Suntharesan Padmanathan",
"speakerRole": "executive",
"ticker": "2082",
"cik": "XSAU000096",
"companyName": "ACWA Power Company",
"observedAt": "2022-11-03",
"observationType": "current_assessment",
"direction": "increasing",
"verificationStatus": "supported",
"documentId": 36108,
"transcriptExternalId": "152013",
"transcriptDate": "2022-11-03",
"fiscalLabel": "Q3 FY2022",
"docType": "earnings_transcript",
"sourceSpan": {
"start": 4254,
"end": 4812
},
"relation": "supports",
"evidenceRole": "direct_development"
}
]
},
{
"cik": "XMUS000029",
"ticker": "VOES",
"companyName": "Voltamp Energy SAOG",
"sector": "Industrials",
"joinedAt": "2025-03-17",
"lastObserved": "2025-03-17",
"observationCount": 1,
"netDirection": 1,
"divergent": false,
"latestQuote": {
"observationId": 0,
"quote": "What are the negative contributors? Concerns are there in terms of supply chain issues. This is continuity -- continuing. There are -- they are impacting our production flow and utilization primarily…",
"statement": "Supply chain issues from geopolitical conflicts (Gaza, Ukraine, Red Sea) and steep market demand are impacting production flow and utilization, with suppliers unable to confirm deliveries.",
"speakerName": "Sayyid Bin Hamad Al-Busaidi",
"speakerRole": "executive",
"ticker": "VOES",
"cik": "XMUS000029",
"companyName": "Voltamp Energy SAOG",
"observedAt": "2025-03-17",
"observationType": "current_assessment",
"direction": "increasing",
"verificationStatus": "normalized",
"documentId": 58127,
"transcriptExternalId": "49767",
"transcriptDate": "2025-03-17",
"fiscalLabel": "Q4 FY2024",
"docType": "earnings_transcript",
"sourceSpan": {
"start": 10596,
"end": 11179
},
"relation": "supports",
"evidenceRole": "direct_development"
},
"quotes": [
{
"observationId": 0,
"quote": "What are the negative contributors? Concerns are there in terms of supply chain issues. This is continuity -- continuing. There are -- they are impacting our production flow and utilization primarily…",
"statement": "Supply chain issues from geopolitical conflicts (Gaza, Ukraine, Red Sea) and steep market demand are impacting production flow and utilization, with suppliers unable to confirm deliveries.",
"speakerName": "Sayyid Bin Hamad Al-Busaidi",
"speakerRole": "executive",
"ticker": "VOES",
"cik": "XMUS000029",
"companyName": "Voltamp Energy SAOG",
"observedAt": "2025-03-17",
"observationType": "current_assessment",
"direction": "increasing",
"verificationStatus": "normalized",
"documentId": 58127,
"transcriptExternalId": "49767",
"transcriptDate": "2025-03-17",
"fiscalLabel": "Q4 FY2024",
"docType": "earnings_transcript",
"sourceSpan": {
"start": 10596,
"end": 11179
},
"relation": "supports",
"evidenceRole": "direct_development"
}
]
}
],
"policyVoices": [],
"spread": [
{
"sector": "Utilities",
"firstMonth": "2022-11",
"joins": [
{
"month": "2022-11",
"tickers": [
"2082"
],
"issuers": [
{
"cik": "XSAU000096",
"ticker": "2082"
}
]
}
],
"issuerCount": 1
},
{
"sector": "Industrials",
"firstMonth": "2025-03",
"joins": [
{
"month": "2025-03",
"tickers": [
"VOES"
],
"issuers": [
{
"cik": "XMUS000029",
"ticker": "VOES"
}
]
},
{
"month": "2026-03",
"tickers": [
"4142"
],
"issuers": [
{
"cik": "XSAU000182",
"ticker": "4142"
}
]
}
],
"issuerCount": 9
}
],
"edges": [],
"nodes": [],
"metricsGrain": "quarter",
"definition": {
"inclusion": "Management explicit characterization of operating environment as complex due to regional geopolitical factors and supply chain disruption; evidence of increased provisions for risk management; stateme…",
"exclusion": "Generic references to market conditions, routine risk disclosures, company-specific execution issues without external driver attribution, or supply chain mentions without geopolitical context.",
"whyUseful": "Analysts assessing duration and severity of regional operating headwinds for project-based industries; evaluating whether disruption is localized or spreading; comparing management confidence in norma…"
},
"membersTotal": 15,
"membersOffset": 0,
"membersNextOffset": 2
}{
"error": "<string>",
"code": "unknown_parameter",
"param": "<string>",
"allowed": [
"<string>"
]
}{
"error": "<string>",
"code": "unknown_parameter",
"param": "<string>",
"allowed": [
"<string>"
]
}{
"error": "<string>",
"code": "unknown_parameter",
"param": "<string>",
"allowed": [
"<string>"
]
}{
"error": "<string>",
"code": "unknown_parameter",
"param": "<string>",
"allowed": [
"<string>"
]
}Intelligence
Narrative detail
One narrative: header, daily metrics, member issuers with join dates and quotes, sector spread and its claim-graph edges.
GET
/
api
/
v1
/
intelligence
/
narratives
/
{id}
Narrative detail
curl --request GET \
--url https://astreus.ai/api/v1/intelligence/narratives/{id} \
--header 'X-API-KEY: <api-key>'import requests
url = "https://astreus.ai/api/v1/intelligence/narratives/{id}"
headers = {"X-API-KEY": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-KEY': '<api-key>'}};
fetch('https://astreus.ai/api/v1/intelligence/narratives/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://astreus.ai/api/v1/intelligence/narratives/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-KEY: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://astreus.ai/api/v1/intelligence/narratives/{id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-KEY", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://astreus.ai/api/v1/intelligence/narratives/{id}")
.header("X-API-KEY", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://astreus.ai/api/v1/intelligence/narratives/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-KEY"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"narrativeId": 10021258,
"name": "Regional geopolitical and supply chain disruption affecting project execution",
"description": "Operating environment complexity in 2026 driven by regional geopolitical developments combined with ongoing supply chain disruption, creating execution challenges and uncertainty for project-based bus…",
"status": "active",
"asOf": "2026-10-06",
"lifecycleState": "accelerating",
"breadth": 15,
"sectorCount": 5,
"firstObserved": "2022-11-03",
"lastObserved": "2026-09-22",
"memberObservations": 23,
"netDirection": 0.3157894736842105,
"forwardShare": 0.08695652173913043,
"metrics": [
{
"date": "2022-12-31",
"volume": 1,
"volume28d": 1,
"velocity": 1,
"acceleration": 1,
"breadth": 1,
"netDirection": 1,
"forwardShare": 0,
"lifecycleState": "emerging"
},
{
"date": "2023-03-31",
"volume": 0,
"volume28d": 0,
"velocity": -1,
"acceleration": -2,
"breadth": 1,
"netDirection": null,
"forwardShare": null,
"lifecycleState": "emerging"
}
],
"members": [
{
"cik": "XSAU000096",
"ticker": "2082",
"companyName": "ACWA Power Company",
"sector": "Utilities",
"joinedAt": "2022-11-03",
"lastObserved": "2023-11-02",
"observationCount": 2,
"netDirection": 0.5,
"divergent": false,
"latestQuote": {
"observationId": 0,
"quote": "At the same time, we know all the context that we believe in high interest rates, inflation, which is subsidizing in some parts, but in some past remains acute particularly when we go to EPC contracts…",
"statement": "Operating environment characterized by high interest rates, persistent inflation in EPC contracts, and ongoing supply chain disruptions from COVID and Russia-Ukraine geopolitical tensions",
"speakerName": "Marco Arcelli",
"speakerRole": "executive",
"ticker": "2082",
"cik": "XSAU000096",
"companyName": "ACWA Power Company",
"observedAt": "2023-11-02",
"observationType": "current_assessment",
"direction": null,
"verificationStatus": "supported",
"documentId": 36104,
"transcriptExternalId": "103809",
"transcriptDate": "2023-11-02",
"fiscalLabel": "Q3 FY2023",
"docType": "earnings_transcript",
"sourceSpan": {
"start": 7983,
"end": 8455
},
"relation": "supports",
"evidenceRole": "direct_development"
},
"quotes": [
{
"observationId": 0,
"quote": "At the same time, we know all the context that we believe in high interest rates, inflation, which is subsidizing in some parts, but in some past remains acute particularly when we go to EPC contracts…",
"statement": "Operating environment characterized by high interest rates, persistent inflation in EPC contracts, and ongoing supply chain disruptions from COVID and Russia-Ukraine geopolitical tensions",
"speakerName": "Marco Arcelli",
"speakerRole": "executive",
"ticker": "2082",
"cik": "XSAU000096",
"companyName": "ACWA Power Company",
"observedAt": "2023-11-02",
"observationType": "current_assessment",
"direction": null,
"verificationStatus": "supported",
"documentId": 36104,
"transcriptExternalId": "103809",
"transcriptDate": "2023-11-02",
"fiscalLabel": "Q3 FY2023",
"docType": "earnings_transcript",
"sourceSpan": {
"start": 7983,
"end": 8455
},
"relation": "supports",
"evidenceRole": "direct_development"
},
{
"observationId": 0,
"quote": "But realistically, and as you all know, within the framework of sort of unprecedented global geopolitical tensions and significant economic stresses, which are -- there is no end in sight and which ar…",
"statement": "Operating in persistent higher cost and interest rate environment with no end in sight, exacerbated by geopolitical tensions, economic stresses, and supply-demand imbalances from war.",
"speakerName": "Suntharesan Padmanathan",
"speakerRole": "executive",
"ticker": "2082",
"cik": "XSAU000096",
"companyName": "ACWA Power Company",
"observedAt": "2022-11-03",
"observationType": "current_assessment",
"direction": "increasing",
"verificationStatus": "supported",
"documentId": 36108,
"transcriptExternalId": "152013",
"transcriptDate": "2022-11-03",
"fiscalLabel": "Q3 FY2022",
"docType": "earnings_transcript",
"sourceSpan": {
"start": 4254,
"end": 4812
},
"relation": "supports",
"evidenceRole": "direct_development"
}
]
},
{
"cik": "XMUS000029",
"ticker": "VOES",
"companyName": "Voltamp Energy SAOG",
"sector": "Industrials",
"joinedAt": "2025-03-17",
"lastObserved": "2025-03-17",
"observationCount": 1,
"netDirection": 1,
"divergent": false,
"latestQuote": {
"observationId": 0,
"quote": "What are the negative contributors? Concerns are there in terms of supply chain issues. This is continuity -- continuing. There are -- they are impacting our production flow and utilization primarily…",
"statement": "Supply chain issues from geopolitical conflicts (Gaza, Ukraine, Red Sea) and steep market demand are impacting production flow and utilization, with suppliers unable to confirm deliveries.",
"speakerName": "Sayyid Bin Hamad Al-Busaidi",
"speakerRole": "executive",
"ticker": "VOES",
"cik": "XMUS000029",
"companyName": "Voltamp Energy SAOG",
"observedAt": "2025-03-17",
"observationType": "current_assessment",
"direction": "increasing",
"verificationStatus": "normalized",
"documentId": 58127,
"transcriptExternalId": "49767",
"transcriptDate": "2025-03-17",
"fiscalLabel": "Q4 FY2024",
"docType": "earnings_transcript",
"sourceSpan": {
"start": 10596,
"end": 11179
},
"relation": "supports",
"evidenceRole": "direct_development"
},
"quotes": [
{
"observationId": 0,
"quote": "What are the negative contributors? Concerns are there in terms of supply chain issues. This is continuity -- continuing. There are -- they are impacting our production flow and utilization primarily…",
"statement": "Supply chain issues from geopolitical conflicts (Gaza, Ukraine, Red Sea) and steep market demand are impacting production flow and utilization, with suppliers unable to confirm deliveries.",
"speakerName": "Sayyid Bin Hamad Al-Busaidi",
"speakerRole": "executive",
"ticker": "VOES",
"cik": "XMUS000029",
"companyName": "Voltamp Energy SAOG",
"observedAt": "2025-03-17",
"observationType": "current_assessment",
"direction": "increasing",
"verificationStatus": "normalized",
"documentId": 58127,
"transcriptExternalId": "49767",
"transcriptDate": "2025-03-17",
"fiscalLabel": "Q4 FY2024",
"docType": "earnings_transcript",
"sourceSpan": {
"start": 10596,
"end": 11179
},
"relation": "supports",
"evidenceRole": "direct_development"
}
]
}
],
"policyVoices": [],
"spread": [
{
"sector": "Utilities",
"firstMonth": "2022-11",
"joins": [
{
"month": "2022-11",
"tickers": [
"2082"
],
"issuers": [
{
"cik": "XSAU000096",
"ticker": "2082"
}
]
}
],
"issuerCount": 1
},
{
"sector": "Industrials",
"firstMonth": "2025-03",
"joins": [
{
"month": "2025-03",
"tickers": [
"VOES"
],
"issuers": [
{
"cik": "XMUS000029",
"ticker": "VOES"
}
]
},
{
"month": "2026-03",
"tickers": [
"4142"
],
"issuers": [
{
"cik": "XSAU000182",
"ticker": "4142"
}
]
}
],
"issuerCount": 9
}
],
"edges": [],
"nodes": [],
"metricsGrain": "quarter",
"definition": {
"inclusion": "Management explicit characterization of operating environment as complex due to regional geopolitical factors and supply chain disruption; evidence of increased provisions for risk management; stateme…",
"exclusion": "Generic references to market conditions, routine risk disclosures, company-specific execution issues without external driver attribution, or supply chain mentions without geopolitical context.",
"whyUseful": "Analysts assessing duration and severity of regional operating headwinds for project-based industries; evaluating whether disruption is localized or spreading; comparing management confidence in norma…"
},
"membersTotal": 15,
"membersOffset": 0,
"membersNextOffset": 2
}{
"error": "<string>",
"code": "unknown_parameter",
"param": "<string>",
"allowed": [
"<string>"
]
}{
"error": "<string>",
"code": "unknown_parameter",
"param": "<string>",
"allowed": [
"<string>"
]
}{
"error": "<string>",
"code": "unknown_parameter",
"param": "<string>",
"allowed": [
"<string>"
]
}{
"error": "<string>",
"code": "unknown_parameter",
"param": "<string>",
"allowed": [
"<string>"
]
}Authorizations
apiKeycognitoIdToken
Astreus API key (pk_live_...), created on the Developers page in the terminal. Also accepted as Authorization: Bearer pk_live_....
Path Parameters
Query Parameters
Members per page, 1–100.
Required range:
1 <= x <= 100Members to skip. 0–100000, default 0.
Required range:
0 <= x <= 100000Member order: joined (first joiner first, as served), mentions or recent.
Available options:
joined, mentions, recent Quotes per member, 0–30.
Required range:
0 <= x <= 30One issuer's CIK or platform key. Any members* parameter adds membersTotal, membersOffset and membersNextOffset.
Response
OK
Inferred from captured responses: every field shown was returned by a real call; a field may be absent or null on other calls.
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes