API Reference

NEXUS Intelligence API

Integrate signal intelligence, prediction data, investment theses, and market quotes directly into your systems. The API follows RESTful conventions, returns JSON, and uses Bearer token authentication.

Protocol

HTTPS / REST

Format

JSON

Auth

Bearer Token

Note

API access requires an active subscription. Generate keys from your account settings. Keys use the sk-nxs- prefix.

#Authentication

All requests must include your API key in the Authorization header using the Bearer scheme. Keys are scoped to your subscription tier and respect the same access controls as the web interface.

Shell

1curl -H "Authorization: Bearer sk-nxs-your-key-here" \
2  https://nexushq.xyz/api/v1/signals

Warning

Never expose your API key in client-side code or public repositories. If a key is compromised, revoke it immediately from your settings page and generate a new one.

#Base URL

All endpoints are prefixed with /api/v1. Use HTTPS for all requests.

Shell

1https://nexushq.xyz/api/v1

#Response Format

Every response wraps data in a consistent envelope. Successful responses include a data object and an optional meta object with rate limit info. Errors return a structured error object.

Success Response

JSON

1{
2  "data": { ... },
3  "meta": {
4    "timestamp": "2026-03-09T12:00:00Z",
5    "tier": "analyst",
6    "rateLimit": {
7      "remaining": 29,
8      "resetAt": "2026-03-09T12:01:00Z"
9    }
10  }
11}

Error Response

JSON

1{
2  "error": {
3    "code": "rate_limited",
4    "message": "Rate limit exceeded",
5    "retryAfter": "2026-03-09T12:01:00Z"
6  }
7}

#Response Headers

Rate limit information is included in every response via headers:

X-RateLimit-RemainingNumber of requests remaining in the current window

X-RateLimit-ResetISO 8601 timestamp when the rate limit window resets

X-Request-IdUnique request identifier for debugging and support

#Rate Limits

Rate limits are enforced per API key and vary by subscription tier. When you exceed a limit, the API returns 429 with a retryAfter timestamp.

Tier	Per Minute	Per Hour	Per Day
Analyst	30	500	5,000
Operator	120	2,000	20,000
Institution	600	10,000	100,000

#Error Handling

The API uses standard HTTP status codes. All error responses include a machine-readable code and a human-readable message.

Status	Code	Description
401	unauthorized	Missing or invalid API key
403	insufficient_tier	Your subscription tier does not have access to this endpoint
404	not_found	The requested resource does not exist
422	validation_error	Invalid query parameters. Check the error message for details
429	rate_limited	Rate limit exceeded. Retry after the X-RateLimit-Reset timestamp
500	internal_error	An unexpected server error occurred. Contact support if persistent

Error Response Example

JSON

1{
2  "error": {
3    "code": "insufficient_tier",
4    "message": "The /v1/theses endpoint requires an Operator tier subscription or higher"
5  }
6}

Endpoints

GET/v1/signalsanalyst+

List Signals

Retrieve detected geopolitical, market, OSINT, and systemic risk signals. Returns signals ordered by detection time, with full layer classification and market sector mapping.

Parameters

limitinteger

Max results (1-200)Default: 50

offsetinteger

Pagination offsetDefault: 0

min_intensityinteger

Minimum signal intensity (1-5)Default: 1

statusstring

Filter by status: upcoming, active, passed

categorystring

Filter by category: geopolitical, market, osint, systemic

Example Request

Shell

1curl -s "https://nexushq.xyz/api/v1/signals?limit=10&min_intensity=3" \
2  -H "Authorization: Bearer sk-nxs-your-key-here"

Example Response

JSON

1{
2  "data": {
3    "signals": [
4      {
5        "id": 142,
6        "title": "South China Sea naval buildup",
7        "description": "Satellite imagery confirms increased PLA Navy...",
8        "date": "2026-03-09",
9        "intensity": 4,
10        "category": "geopolitical",
11        "layers": ["GEO", "OSI"],
12        "marketSectors": ["defense", "shipping"],
13        "status": "active",
14        "createdAt": "2026-03-08T14:22:00Z"
15      }
16    ],
17    "pagination": { "limit": 10, "offset": 0, "count": 1 }
18  },
19  "meta": {
20    "timestamp": "2026-03-09T12:00:00Z",
21    "tier": "analyst",
22    "rateLimit": { "remaining": 29, "resetAt": "2026-03-09T12:01:00Z" }
23  }
24}

GET/v1/predictionsanalyst+

List Predictions

Access prediction claims with Brier scoring, direction/level accuracy, and market regime tagging. Predictions are scored against real market outcomes for full transparency.

Parameters

limitinteger

Max results (1-200)Default: 50

offsetinteger

Pagination offsetDefault: 0

outcomestring

Filter: confirmed, denied, partial, expired

Example Request

Shell

1curl -s "https://nexushq.xyz/api/v1/predictions?outcome=confirmed" \
2  -H "Authorization: Bearer sk-nxs-your-key-here"

Example Response

JSON

1{
2  "data": {
3    "predictions": [
4      {
5        "id": 87,
6        "claim": "Oil breaks $95 within 14 days",
7        "confidence": 0.72,
8        "category": "commodity",
9        "direction": "up",
10        "priceTarget": 95.0,
11        "referenceSymbol": "CL=F",
12        "outcome": "confirmed",
13        "score": 0.92,
14        "directionCorrect": true,
15        "regimeAtCreation": "risk-off",
16        "createdAt": "2026-02-20T10:00:00Z"
17      }
18    ],
19    "pagination": { "limit": 50, "offset": 0, "count": 1 }
20  }
21}

GET/v1/thesesoperator+

List Theses

Retrieve AI-generated investment theses with convergence analysis, trading actions, and risk scenarios. Theses synthesize multiple signal layers into actionable intelligence.

Parameters

limitinteger

Max results (1-50)Default: 20

offsetinteger

Pagination offsetDefault: 0

statusstring

Filter: active, closed, invalidatedDefault: active

Example Request

Shell

1curl -s "https://nexushq.xyz/api/v1/theses?status=active" \
2  -H "Authorization: Bearer sk-nxs-your-key-here"

Example Response

JSON

1{
2  "data": {
3    "theses": [
4      {
5        "id": 15,
6        "title": "Hormuz closure hedge via tanker equities",
7        "status": "active",
8        "marketRegime": "risk-off",
9        "overallConfidence": 0.78,
10        "executiveSummary": "Escalating tensions in the Strait of Hormuz...",
11        "tradingActions": [
12          { "symbol": "STNG", "action": "buy", "weight": 0.4 },
13          { "symbol": "FRO", "action": "buy", "weight": 0.35 }
14        ],
15        "symbols": ["STNG", "FRO", "TNK"],
16        "generatedAt": "2026-03-07T08:00:00Z"
17      }
18    ],
19    "pagination": { "limit": 20, "offset": 0, "count": 1 }
20  }
21}

GET/v1/market/quoteanalyst+

Market Quote

Get a real-time market quote for any US equity, ETF, or cryptocurrency. Crypto symbols (BTC, ETH, XRP) are auto-detected and routed to the correct data feed.

Parameters

symbolstringrequired

Ticker symbol, e.g. AAPL, SPY, BTC

Example Request

Shell

1curl -s "https://nexushq.xyz/api/v1/market/quote?symbol=AAPL" \
2  -H "Authorization: Bearer sk-nxs-your-key-here"

Example Response

JSON

1{
2  "data": {
3    "symbol": "AAPL",
4    "quote": {
5      "price": 187.42,
6      "change": 2.15,
7      "changePercent": "1.16%",
8      "volume": 54823100,
9      "latestTradingDay": "2026-03-07"
10    }
11  }
12}

GET/v1/newsanalyst+

News Feed

Retrieve the latest intelligence news feed with source bias classification. Aggregates multiple OSINT and financial news sources with automated categorization.

Parameters

limitinteger

Max results (1-100)Default: 30

Example Request

Shell

1curl -s "https://nexushq.xyz/api/v1/news?limit=5" \
2  -H "Authorization: Bearer sk-nxs-your-key-here"

Example Response

JSON

1{
2  "data": {
3    "articles": [
4      {
5        "title": "Pentagon confirms carrier group deployment to Western Pacific",
6        "url": "https://reuters.com/...",
7        "source": "Reuters",
8        "date": "2026-03-09T10:30:00Z",
9        "category": "conflict",
10        "bias": "center"
11      }
12    ],
13    "pagination": { "limit": 5, "count": 1 }
14  }
15}

Ready to integrate?

Generate your API key and start pulling intelligence data in minutes.

Generate API Key Create Account

API Reference

NEXUS Intelligence API

Protocol

HTTPS / REST

Format

JSON

Auth

Bearer Token

Note

API access requires an active subscription. Generate keys from your account settings. Keys use the sk-nxs- prefix.

#Authentication

All requests must include your API key in the Authorization header using the Bearer scheme. Keys are scoped to your subscription tier and respect the same access controls as the web interface.

Shell

1curl -H "Authorization: Bearer sk-nxs-your-key-here" \
2  https://nexushq.xyz/api/v1/signals

Warning

Never expose your API key in client-side code or public repositories. If a key is compromised, revoke it immediately from your settings page and generate a new one.

#Base URL

All endpoints are prefixed with /api/v1. Use HTTPS for all requests.

Shell

1https://nexushq.xyz/api/v1

#Response Format

Every response wraps data in a consistent envelope. Successful responses include a data object and an optional meta object with rate limit info. Errors return a structured error object.

Success Response

JSON

1{
2  "data": { ... },
3  "meta": {
4    "timestamp": "2026-03-09T12:00:00Z",
5    "tier": "analyst",
6    "rateLimit": {
7      "remaining": 29,
8      "resetAt": "2026-03-09T12:01:00Z"
9    }
10  }
11}

Error Response

JSON

1{
2  "error": {
3    "code": "rate_limited",
4    "message": "Rate limit exceeded",
5    "retryAfter": "2026-03-09T12:01:00Z"
6  }
7}

#Response Headers

Rate limit information is included in every response via headers:

X-RateLimit-RemainingNumber of requests remaining in the current window

X-RateLimit-ResetISO 8601 timestamp when the rate limit window resets

X-Request-IdUnique request identifier for debugging and support

#Rate Limits

Rate limits are enforced per API key and vary by subscription tier. When you exceed a limit, the API returns 429 with a retryAfter timestamp.

Tier	Per Minute	Per Hour	Per Day
Analyst	30	500	5,000
Operator	120	2,000	20,000
Institution	600	10,000	100,000

#Error Handling

The API uses standard HTTP status codes. All error responses include a machine-readable code and a human-readable message.

Status	Code	Description
401	unauthorized	Missing or invalid API key
403	insufficient_tier	Your subscription tier does not have access to this endpoint
404	not_found	The requested resource does not exist
422	validation_error	Invalid query parameters. Check the error message for details
429	rate_limited	Rate limit exceeded. Retry after the X-RateLimit-Reset timestamp
500	internal_error	An unexpected server error occurred. Contact support if persistent

Error Response Example

JSON

1{
2  "error": {
3    "code": "insufficient_tier",
4    "message": "The /v1/theses endpoint requires an Operator tier subscription or higher"
5  }
6}

Endpoints

GET/v1/signalsanalyst+

List Signals

Retrieve detected geopolitical, market, OSINT, and systemic risk signals. Returns signals ordered by detection time, with full layer classification and market sector mapping.

Parameters

limitinteger

Max results (1-200)Default: 50

offsetinteger

Pagination offsetDefault: 0

min_intensityinteger

Minimum signal intensity (1-5)Default: 1

statusstring

Filter by status: upcoming, active, passed

categorystring

Filter by category: geopolitical, market, osint, systemic

Example Request

Shell

1curl -s "https://nexushq.xyz/api/v1/signals?limit=10&min_intensity=3" \
2  -H "Authorization: Bearer sk-nxs-your-key-here"

Example Response

JSON

1{
2  "data": {
3    "signals": [
4      {
5        "id": 142,
6        "title": "South China Sea naval buildup",
7        "description": "Satellite imagery confirms increased PLA Navy...",
8        "date": "2026-03-09",
9        "intensity": 4,
10        "category": "geopolitical",
11        "layers": ["GEO", "OSI"],
12        "marketSectors": ["defense", "shipping"],
13        "status": "active",
14        "createdAt": "2026-03-08T14:22:00Z"
15      }
16    ],
17    "pagination": { "limit": 10, "offset": 0, "count": 1 }
18  },
19  "meta": {
20    "timestamp": "2026-03-09T12:00:00Z",
21    "tier": "analyst",
22    "rateLimit": { "remaining": 29, "resetAt": "2026-03-09T12:01:00Z" }
23  }
24}

GET/v1/predictionsanalyst+

List Predictions

Access prediction claims with Brier scoring, direction/level accuracy, and market regime tagging. Predictions are scored against real market outcomes for full transparency.

Parameters

limitinteger

Max results (1-200)Default: 50

offsetinteger

Pagination offsetDefault: 0

outcomestring

Filter: confirmed, denied, partial, expired

Example Request

Shell

1curl -s "https://nexushq.xyz/api/v1/predictions?outcome=confirmed" \
2  -H "Authorization: Bearer sk-nxs-your-key-here"

Example Response

JSON

1{
2  "data": {
3    "predictions": [
4      {
5        "id": 87,
6        "claim": "Oil breaks $95 within 14 days",
7        "confidence": 0.72,
8        "category": "commodity",
9        "direction": "up",
10        "priceTarget": 95.0,
11        "referenceSymbol": "CL=F",
12        "outcome": "confirmed",
13        "score": 0.92,
14        "directionCorrect": true,
15        "regimeAtCreation": "risk-off",
16        "createdAt": "2026-02-20T10:00:00Z"
17      }
18    ],
19    "pagination": { "limit": 50, "offset": 0, "count": 1 }
20  }
21}

GET/v1/thesesoperator+

List Theses

Retrieve AI-generated investment theses with convergence analysis, trading actions, and risk scenarios. Theses synthesize multiple signal layers into actionable intelligence.

Parameters

limitinteger

Max results (1-50)Default: 20

offsetinteger

Pagination offsetDefault: 0

statusstring

Filter: active, closed, invalidatedDefault: active

Example Request

Shell

1curl -s "https://nexushq.xyz/api/v1/theses?status=active" \
2  -H "Authorization: Bearer sk-nxs-your-key-here"

Example Response

JSON

1{
2  "data": {
3    "theses": [
4      {
5        "id": 15,
6        "title": "Hormuz closure hedge via tanker equities",
7        "status": "active",
8        "marketRegime": "risk-off",
9        "overallConfidence": 0.78,
10        "executiveSummary": "Escalating tensions in the Strait of Hormuz...",
11        "tradingActions": [
12          { "symbol": "STNG", "action": "buy", "weight": 0.4 },
13          { "symbol": "FRO", "action": "buy", "weight": 0.35 }
14        ],
15        "symbols": ["STNG", "FRO", "TNK"],
16        "generatedAt": "2026-03-07T08:00:00Z"
17      }
18    ],
19    "pagination": { "limit": 20, "offset": 0, "count": 1 }
20  }
21}

GET/v1/market/quoteanalyst+

Market Quote

Get a real-time market quote for any US equity, ETF, or cryptocurrency. Crypto symbols (BTC, ETH, XRP) are auto-detected and routed to the correct data feed.

Parameters

symbolstringrequired

Ticker symbol, e.g. AAPL, SPY, BTC

Example Request

Shell

1curl -s "https://nexushq.xyz/api/v1/market/quote?symbol=AAPL" \
2  -H "Authorization: Bearer sk-nxs-your-key-here"

Example Response

JSON

1{
2  "data": {
3    "symbol": "AAPL",
4    "quote": {
5      "price": 187.42,
6      "change": 2.15,
7      "changePercent": "1.16%",
8      "volume": 54823100,
9      "latestTradingDay": "2026-03-07"
10    }
11  }
12}

GET/v1/newsanalyst+

News Feed

Retrieve the latest intelligence news feed with source bias classification. Aggregates multiple OSINT and financial news sources with automated categorization.

Parameters

limitinteger

Max results (1-100)Default: 30

Example Request

Shell

1curl -s "https://nexushq.xyz/api/v1/news?limit=5" \
2  -H "Authorization: Bearer sk-nxs-your-key-here"

Example Response

JSON

1{
2  "data": {
3    "articles": [
4      {
5        "title": "Pentagon confirms carrier group deployment to Western Pacific",
6        "url": "https://reuters.com/...",
7        "source": "Reuters",
8        "date": "2026-03-09T10:30:00Z",
9        "category": "conflict",
10        "bias": "center"
11      }
12    ],
13    "pagination": { "limit": 5, "count": 1 }
14  }
15}

Ready to integrate?

Generate your API key and start pulling intelligence data in minutes.

Generate API Key Create Account