Company intelligence
curl --request GET \
--url https://astreus.ai/api/v1/intelligence/company/{id} \
--header 'X-API-KEY: <api-key>'import requests
url = "https://astreus.ai/api/v1/intelligence/company/{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/company/{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/company/{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/company/{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/company/{id}")
.header("X-API-KEY", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://astreus.ai/api/v1/intelligence/company/{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{
"ticker": "NVDA",
"cik": "0001045810",
"asOf": "2026-08-26",
"exposures": [],
"causalProfile": [
{
"observationId": 3071,
"causeStatement": "Agentic AI has arrived.",
"effectStatement": "NVIDIA's Q1 FY2027 demand has gone parabolic.",
"direction": "increasing",
"observedAt": "2026-05-20",
"quote": "The reason is simple, agentic AI has arrived.",
"speakerName": "Jen-Hsun Huang",
"edgeId": "e-ai-dccapex",
"edgeState": "validated",
"validation": {
"method": "event_study",
"eventWindow": "same + next fiscal quarter",
"effectLabel": "+38% capex growth YoY",
"effectSize": 38,
"effectUnit": "%",
"lagDays": 45,
"nEvents": 24,
"pValue": 0.0002,
"qValue": 0.001,
"verdict": "supported",
"testedAt": "2026-06-28",
"scope": "hyperscalers + AI infrastructure buyers",
"note": "Strongest edge in the graph by q-value."
}
},
{
"observationId": 744523,
"causeStatement": "More compute availability",
"effectStatement": "More profitable tokens generated and increased profit for services",
"direction": null,
"observedAt": "2026-08-26",
"quote": "if we had more compute, we could generate more profitable tokens, which results in more profit for all of the services",
"speakerName": "Jen-Hsun Huang",
"edgeId": null,
"edgeState": null,
"validation": null
}
],
"credibility": {
"ticker": "NVDA",
"score": null,
"sectorPercentile": null,
"scoredCount": 2,
"deliveredCount": 1,
"beatCount": 1,
"missedCount": 0,
"pendingCount": 10,
"rows": [
{
"observationId": 744469,
"concept": "third-party capital raising target",
"guidedAt": "2026-08-26",
"periodLabel": "will raise",
"guidedValue": 500,
"unit": "usd_billions",
"realizedValue": null,
"realizedSource": null,
"errorPct": null,
"verdict": "pending",
"quote": "establish financing platforms that will raise over $500 billion of third-party capital.",
"speakerName": "Colette Kress"
},
{
"observationId": 1904,
"concept": "total revenue guidance",
"guidedAt": "2025-08-27",
"periodLabel": "outlook for the third quarter",
"guidedValue": 54,
"unit": "usd_billions",
"realizedValue": 57,
"realizedSource": "Q3 FY2026 as reported",
"errorPct": 5.555555555555555,
"verdict": "beat",
"quote": "Total revenue is expected to be $54 billion, plus or minus 2%.",
"speakerName": "Colette Kress"
}
],
"bestCall": {
"observationId": 1904,
"concept": "total revenue guidance",
"guidedAt": "2025-08-27",
"periodLabel": "outlook for the third quarter",
"guidedValue": 54,
"unit": "usd_billions",
"realizedValue": 57,
"realizedSource": "Q3 FY2026 as reported",
"errorPct": 5.555555555555555,
"verdict": "beat",
"quote": "Total revenue is expected to be $54 billion, plus or minus 2%.",
"speakerName": "Colette Kress"
},
"worstCall": {
"observationId": 743,
"concept": "software revenue annual run rate",
"guidedAt": "2024-08-28",
"periodLabel": "exiting this year",
"guidedValue": 2,
"unit": "usd_billions",
"realizedValue": 2,
"realizedSource": "FY2025 Q4 call confirmation",
"errorPct": 0,
"verdict": "delivered",
"quote": "We expect our software, SaaS and support revenue to approach a $2 billion annual run rate exiting this year",
"speakerName": "Colette Kress"
},
"coverageNote": "Guidance quotes and values are live extractions; reconciled verdicts cover the curated demo set. Full XBRL reconciliation ships with P3.3."
},
"forecast": {
"ticker": "NVDA",
"horizonLabel": "next 2 quarters",
"abnormalReturnMeanPct": 3.1,
"abnormalReturnBand": [
0.4,
5.8
],
"fundamentalMetric": "Data-center revenue growth",
"fundamentalDeltaLabel": "+9 pts vs consensus path",
"attributions": [
{
"kind": "narrative",
"label": "Surging AI Compute Demand accelerating",
"detail": "Narrative #174 velocity and breadth both rising at the latest read.",
"weightPct": 44,
"refId": "174"
},
{
"kind": "edge",
"label": "Validated: AI demand → data-center capex",
"detail": "+38% capex growth, q<0.001, n=24 — the strongest edge in the graph.",
"weightPct": 31,
"refId": "e-ai-dccapex",
"edgeState": "validated"
}
],
"modelLabel": "Preview model — every input shown above",
"backtestNote": "We only score this against what was actually knowable at the time. Theme-momentum signals from before the registry went live are excluded, because we'd be marking our own homework.",
"asOf": "2026-08-26"
}
}{
"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
Company intelligence
Company intelligence summary: theme exposures, causal claims (causalProfile), the guidance credibility scorecard. An unknown or unpublished company is a 404 (code not_found).
GET
/
api
/
v1
/
intelligence
/
company
/
{id}
Company intelligence
curl --request GET \
--url https://astreus.ai/api/v1/intelligence/company/{id} \
--header 'X-API-KEY: <api-key>'import requests
url = "https://astreus.ai/api/v1/intelligence/company/{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/company/{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/company/{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/company/{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/company/{id}")
.header("X-API-KEY", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://astreus.ai/api/v1/intelligence/company/{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{
"ticker": "NVDA",
"cik": "0001045810",
"asOf": "2026-08-26",
"exposures": [],
"causalProfile": [
{
"observationId": 3071,
"causeStatement": "Agentic AI has arrived.",
"effectStatement": "NVIDIA's Q1 FY2027 demand has gone parabolic.",
"direction": "increasing",
"observedAt": "2026-05-20",
"quote": "The reason is simple, agentic AI has arrived.",
"speakerName": "Jen-Hsun Huang",
"edgeId": "e-ai-dccapex",
"edgeState": "validated",
"validation": {
"method": "event_study",
"eventWindow": "same + next fiscal quarter",
"effectLabel": "+38% capex growth YoY",
"effectSize": 38,
"effectUnit": "%",
"lagDays": 45,
"nEvents": 24,
"pValue": 0.0002,
"qValue": 0.001,
"verdict": "supported",
"testedAt": "2026-06-28",
"scope": "hyperscalers + AI infrastructure buyers",
"note": "Strongest edge in the graph by q-value."
}
},
{
"observationId": 744523,
"causeStatement": "More compute availability",
"effectStatement": "More profitable tokens generated and increased profit for services",
"direction": null,
"observedAt": "2026-08-26",
"quote": "if we had more compute, we could generate more profitable tokens, which results in more profit for all of the services",
"speakerName": "Jen-Hsun Huang",
"edgeId": null,
"edgeState": null,
"validation": null
}
],
"credibility": {
"ticker": "NVDA",
"score": null,
"sectorPercentile": null,
"scoredCount": 2,
"deliveredCount": 1,
"beatCount": 1,
"missedCount": 0,
"pendingCount": 10,
"rows": [
{
"observationId": 744469,
"concept": "third-party capital raising target",
"guidedAt": "2026-08-26",
"periodLabel": "will raise",
"guidedValue": 500,
"unit": "usd_billions",
"realizedValue": null,
"realizedSource": null,
"errorPct": null,
"verdict": "pending",
"quote": "establish financing platforms that will raise over $500 billion of third-party capital.",
"speakerName": "Colette Kress"
},
{
"observationId": 1904,
"concept": "total revenue guidance",
"guidedAt": "2025-08-27",
"periodLabel": "outlook for the third quarter",
"guidedValue": 54,
"unit": "usd_billions",
"realizedValue": 57,
"realizedSource": "Q3 FY2026 as reported",
"errorPct": 5.555555555555555,
"verdict": "beat",
"quote": "Total revenue is expected to be $54 billion, plus or minus 2%.",
"speakerName": "Colette Kress"
}
],
"bestCall": {
"observationId": 1904,
"concept": "total revenue guidance",
"guidedAt": "2025-08-27",
"periodLabel": "outlook for the third quarter",
"guidedValue": 54,
"unit": "usd_billions",
"realizedValue": 57,
"realizedSource": "Q3 FY2026 as reported",
"errorPct": 5.555555555555555,
"verdict": "beat",
"quote": "Total revenue is expected to be $54 billion, plus or minus 2%.",
"speakerName": "Colette Kress"
},
"worstCall": {
"observationId": 743,
"concept": "software revenue annual run rate",
"guidedAt": "2024-08-28",
"periodLabel": "exiting this year",
"guidedValue": 2,
"unit": "usd_billions",
"realizedValue": 2,
"realizedSource": "FY2025 Q4 call confirmation",
"errorPct": 0,
"verdict": "delivered",
"quote": "We expect our software, SaaS and support revenue to approach a $2 billion annual run rate exiting this year",
"speakerName": "Colette Kress"
},
"coverageNote": "Guidance quotes and values are live extractions; reconciled verdicts cover the curated demo set. Full XBRL reconciliation ships with P3.3."
},
"forecast": {
"ticker": "NVDA",
"horizonLabel": "next 2 quarters",
"abnormalReturnMeanPct": 3.1,
"abnormalReturnBand": [
0.4,
5.8
],
"fundamentalMetric": "Data-center revenue growth",
"fundamentalDeltaLabel": "+9 pts vs consensus path",
"attributions": [
{
"kind": "narrative",
"label": "Surging AI Compute Demand accelerating",
"detail": "Narrative #174 velocity and breadth both rising at the latest read.",
"weightPct": 44,
"refId": "174"
},
{
"kind": "edge",
"label": "Validated: AI demand → data-center capex",
"detail": "+38% capex growth, q<0.001, n=24 — the strongest edge in the graph.",
"weightPct": 31,
"refId": "e-ai-dccapex",
"edgeState": "validated"
}
],
"modelLabel": "Preview model — every input shown above",
"backtestNote": "We only score this against what was actually knowable at the time. Theme-momentum signals from before the registry went live are excluded, because we'd be marking our own homework.",
"asOf": "2026-08-26"
}
}{
"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
Ticker symbol (e.g. NVDA), numeric SEC CIK (zero-padding optional), or the platform key of a non-SEC issuer (e.g. XSAU000001 — the cik field of the company payload). A bare ticker always resolves to the SEC registrant.
Response
OK