Authentication
All API requests require a Bearer token. Get your API key from Account → API Keys. Professional plan: 200 req/day. Team: 500. Enterprise: unlimited.
curl https://valixdata.com/api/v1/terminal/pe \
-H "Authorization: Bearer YOUR_API_KEY"
GET /api/v1/terminal/{terminal_id}
Returns live KPI data for the specified terminal. Data freshness: 2–4 hours. All 130 profession IDs supported.
{
"terminal": "pe",
"name": "Private Equity",
"updated_at": "2026-04-01T09:32:00Z",
"freshness_hours": 2.1,
"kpis": [
{
"label": "HY OAS",
"value": "318bps",
"change": "+8bps",
"direction": "up",
"signal": "marginal",
"source": "ICE BofA",
"timestamp": "2026-04-01T09:30:00Z"
},
{
"label": "10Y UST",
"value": "4.28%",
"change": "-6bps",
"direction": "down",
"source": "FRED",
"timestamp": "2026-04-01T09:28:00Z"
}
],
"signals": [...],
"news_count": 12
}
GET /api/v1/brief/{terminal_id}
Returns the latest NOVA morning brief for the specified terminal. Briefs are generated daily at ~1am ET and delivered at 6am ET.
{
"terminal": "pe",
"date": "2026-04-01",
"generated_at": "2026-04-01T06:00:00Z",
"priority_signals": [
{
"level": "high",
"category": "Market",
"headline": "HY OAS at 318bps — 7bps from threshold",
"body": "...",
"aria_confidence": "high",
"sources": ["ICE BofA", "FRED"]
}
],
"market_update": {...},
"news_summary": {...},
"aria_synthesis": "...",
"pdf_url": "https://valixdata.com/briefs/pe/2026-04-01.pdf"
}
POST /api/v1/aria
Send a message to ARIA and receive professional-grade analysis. Optionally include terminal context and document content.
# Request
{
"terminal": "pe",
"message": "What do HY spreads at 318bps mean for my LBO timeline?",
"context": "optional: additional context string"
}
# Response
{
"reply": "At 318bps OAS you are in the marginal zone...",
"confidence": "high",
"terminal": "pe",
"data_used": ["HY OAS", "10Y UST", "VIX"],
"sources": ["ICE BofA", "FRED"],
"tokens_used": 412,
"model": "aria-nd-1"
}
Error Codes
401Unauthorized
Missing or invalid API key.
403Forbidden
Plan does not include API access. Upgrade to Professional or above.
429Rate Limit Exceeded
You have exceeded your plan's daily API quota. Quota resets at midnight ET.
404Terminal Not Found
The terminal ID provided is not valid. See GET /api/v1/terminals for all valid IDs.
503Data Unavailable
Live data temporarily unavailable from upstream source. Retry in 10 minutes.