Loading
Machine-readable access to NEXUS signal convergence scores, regime detection states, calibrated predictions with Brier scoring, and game theory scenario analysis. Built for quant models, research pipelines, and intelligence dashboards.
https://nexushq.xyz/api/v11Generate an API key from your settings page
# Your key is shown once at creation. Store it securely.
# Format: sk-nxs-{32 hex characters}2Make your first request
curl -H "Authorization: Bearer sk-nxs-your-key-here" \
https://nexushq.xyz/api/v1/signals?min_intensity=33Response envelope
{
"data": { ... },
"meta": {
"timestamp": "2026-03-13T12:00:00.000Z",
"tier": "analyst"
}
}All requests require a Bearer token in the Authorization header. Keys are scoped to specific endpoints. Include the required scope when generating your key.
Authorization: Bearer sk-nxs-your-key-heresignalsSignal convergence datapredictionsPredictions + accuracy statsregimeRegime detection statesgame_theoryGame theory scenariosthesesIntelligence thesesmarketMarket quotesRate limits are enforced per API key. Exceeding limits returns 429 with a Retry-After header.
| Tier | Per Minute | Per Hour | Per Day |
|---|---|---|---|
| Analyst | 30 | 500 | 5,000 |
| Operator | 120 | 2,000 | 20,000 |
| Institution | 600 | 10,000 | 100,000 |
Headers: X-RateLimit-Remaining, X-RateLimit-Reset
/api/v1/signalsanalyst+Signal convergence detections with intensity scores (1-5), layer attribution, and market sector mapping. Intensity is computed via Bayesian posterior probability fusion across geopolitical, OSINT, market, and calendar layers.
signals| Name | Type | Description |
|---|---|---|
| limit | number | Max results (default 50, max 200) |
| offset | number | Pagination offset |
| min_intensity | number | Minimum intensity 1-5 (default 1) |
| status | string | Filter: upcoming | active | passed |
| category | string | Filter: celestial | geopolitical | convergence |
{
"data": {
"signals": [
{
"id": "uuid",
"title": "Iran-Israel Escalation Window",
"description": "...",
"date": "2026-03-15",
"intensity": 4,
"category": "geopolitical",
"layers": ["GEO", "MKT", "OSI"],
"marketSectors": ["energy", "defense"],
"status": "upcoming",
"createdAt": "2026-03-13T..."
}
],
"pagination": { "limit": 50, "offset": 0, "count": 12 }
}
}/api/v1/regimeanalyst+Current regime state across 7 dimensions (volatility, growth, monetary, risk appetite, dollar, commodity, geopolitical) plus composite score. Each dimension includes regime classification, directional score (-1 to +1), and confidence level.
regime| Name | Type | Description |
|---|---|---|
| history | boolean | Include historical regime states (default false) |
| history_limit | number | Max history entries (default 30, max 90) |
{
"data": {
"regime": {
"timestamp": "2026-03-13T...",
"composite": "Risk-off with elevated geopolitical tension",
"compositeScore": -0.35,
"volatility": { "regime": "elevated", "score": -0.4, "confidence": 0.82 },
"growth": { "regime": "slowdown", "score": -0.2, "confidence": 0.71 },
"geopolitical": { "regime": "escalating", "score": -0.6, "confidence": 0.88 }
}
}
}/api/v1/predictionsanalyst+Calibrated predictions with transparent Brier scoring, regime-aware tagging, and direction vs level split scoring. Pre-event predictions are locked before the event window.
predictions| Name | Type | Description |
|---|---|---|
| limit | number | Max results (default 50, max 200) |
| offset | number | Pagination offset |
| outcome | string | Filter: confirmed | denied | partial | expired |
{
"data": {
"predictions": [
{
"id": "uuid",
"claim": "WTI crude above $85 within 14 days",
"timeframe": "14 days",
"deadline": "2026-03-27",
"confidence": 0.72,
"category": "market",
"direction": "up",
"priceTarget": 85,
"referenceSymbol": "WTI",
"outcome": null,
"score": null,
"regimeAtCreation": "transitional",
"preEvent": true,
"createdAt": "2026-03-13T..."
}
]
}
}/api/v1/predictions/accuracyanalyst+Aggregate calibration statistics: overall Brier score, accuracy rate, direction/level split accuracy, breakdown by category and regime, and calibration curve data.
predictions| Name | Type | Description |
|---|---|---|
| category | string | Filter: market | geopolitical |
{
"data": {
"totalResolved": 142,
"brierScore": 0.187,
"accuracyRate": 0.68,
"directionAccuracy": 0.74,
"levelAccuracy": 0.41,
"byOutcome": { "confirmed": 78, "denied": 34, "partial": 18, "expired": 12 },
"byCategory": {
"market": { "count": 89, "avgBrier": 0.165 },
"geopolitical": { "count": 53, "avgBrier": 0.221 }
},
"calibration": [
{ "confidenceBucket": 0.5, "predictions": 30, "actualRate": 0.47 },
{ "confidenceBucket": 0.7, "predictions": 45, "actualRate": 0.69 }
]
}
}/api/v1/game-theoryoperator+Active game theory scenarios with Nash equilibria, Schelling focal points, escalation ladders, dominant strategies, and market impact assessments. Includes wartime branch state tracking.
game_theory| Name | Type | Description |
|---|---|---|
| limit | number | Max results (default 20, max 50) |
| offset | number | Pagination offset |
| scenario_id | string | Fetch a specific scenario by ID |
{
"data": {
"scenarios": [
{
"id": "iran-nuclear-2026",
"title": "Iran Nuclear Escalation",
"analysis": {
"nashEquilibria": [{
"strategies": { "iran": "Accelerate", "us": "Sanctions" },
"payoffs": { "iran": -2, "us": -3 },
"stability": "unstable",
"marketImpact": { "direction": "bearish", "magnitude": "high", "sectors": ["energy", "defense"] }
}],
"escalationLadder": [{
"level": 1,
"description": "Enrichment threshold breach",
"probability": 0.45,
"marketImpact": { "direction": "bearish", "magnitude": "medium" }
}]
},
"state": {
"regime": "transitional",
"triggeredThresholds": ["Enrichment above 60%"],
"updatedAt": "2026-03-12T..."
}
}
]
}
}/api/v1/thesesoperator+Intelligence theses synthesising signal convergence, regime state, and market analysis into actionable assessments with trading recommendations and risk scenarios.
theses| Name | Type | Description |
|---|---|---|
| limit | number | Max results (default 20, max 50) |
| offset | number | Pagination offset |
| status | string | Filter: active | expired | superseded |
{
"data": {
"theses": [
{
"id": "uuid",
"title": "Energy Supply Disruption Thesis",
"status": "active",
"marketRegime": "risk_off",
"volatilityOutlook": "elevated",
"overallConfidence": 0.71,
"executiveSummary": "...",
"tradingActions": [...],
"symbols": ["WTI", "XOM", "LMT"]
}
]
}
}/api/v1/market/quoteanalyst+Real-time market quotes via Alpha Vantage. Auto-detects crypto symbols (BTC, ETH, XRP) vs equities.
market| Name | Type | Description |
|---|---|---|
| symbol* | string | Ticker symbol (e.g. AAPL, BTC, WTI) |
{
"data": {
"symbol": "AAPL",
"price": 178.52,
"change": -1.23,
"changePercent": "-0.68%",
"volume": 54200000
}
}| Status | Code | Description |
|---|---|---|
| 401 | missing_api_key | No Authorization header provided |
| 401 | invalid_api_key | Key is malformed, revoked, or not found |
| 403 | insufficient_scope | Key lacks required scope for this endpoint |
| 403 | insufficient_tier | Subscription tier too low for this endpoint |
| 403 | api_access_disabled | API access not included in your tier |
| 429 | rate_limited | Rate limit exceeded. Check Retry-After header |
| 500 | internal_error | Server error. Contact support if persistent |
{
"error": "rate_limited",
"message": "Rate limit exceeded. Try again in 12 seconds.",
"retryAfter": 12
}Generate your API key and start integrating NEXUS intelligence into your pipeline.