All docs Nebula docs All endpoints Interactive docs Markdown OpenAPI JSON
  1. REST API
  2. Intelligence

Intelligence

GET /insights
ListInsights

Returns curated intelligence globally or for exactly one resolved asset or non-asset subject. The unscoped response spans all supported asset classes and subjects. Asset selectors support equities, commodities, indices, and crypto assets returned by GET /assets; commodity and index IDs use asset_class=equity. Parameter rules: asset_class requires asset_id. asset_id requires asset_class. subject_id and asset_class cannot be combined. subject_id and asset_id cannot be combined.

Parameters

asset_id string QUERY

Canonical identifier returned by /assets. Stock, commodity, and index IDs are normally ticker or market symbols and use asset_class=equity; crypto IDs are canonical crypto slugs. asset_class is mandatory whenever asset_id is present.

Example:NVDA

asset_class string QUERY

Namespace of asset_id, or the market class for endpoints with a class-scoped global view. Stocks, commodities, and indices use equity. Equity is the documented default only where the endpoint description states a default.

Allowed values
equitycrypto

Example:equity

subject_id string QUERY

Canonical non-asset identifier returned by /subjects. It cannot be combined with asset_id or asset_class.

Example:person:donald_trump

limit integer QUERY

Maximum results returned.

Example:50

offset integer QUERY

Number of results skipped.

Example:0

start_time_after string (date-time) QUERY

Only items starting after this RFC3339 time.

Example:2026-08-01T00:00:00Z

start_time_before string (date-time) QUERY

Only items starting before this RFC3339 time.

Example:2026-08-07T00:00:00Z

tags string QUERY

Comma-separated tags.

Example:earnings,regulation

exclude_tags string QUERY

Comma-separated excluded tags.

Example:rumour

categories string QUERY

Comma-separated categories.

Example:company,macro

domains string QUERY

Comma-separated domains.

Example:equities,macro

order_by string QUERY

Result ordering. Defaults to updated_at_desc.

Allowed values
start_time_ascstart_time_descupdated_at_ascupdated_at_desccreated_at_asccreated_at_descimportance_score_ascimportance_score_desc

Default:updated_at_desc

cURL Example

curl --request GET \
  --url 'https://nebula-api.hiddensystems.ai/api/v1/public/insights' \
  --header 'X-API-Key: YOUR_API_KEY'

Responses

200 OK
400 Bad Request
401 Unauthorized
402 Credit balance exhausted
403 Forbidden
404 Not Found
429 Too Many Requests
500 Internal Server Error
503 Service Unavailable

Media type application/json

insights
array<object> required

Curated intelligence items matching the supplied filters.
insights[].category
string optional

Primary intelligence category when assigned.

insights[].domains
array<string> required

Market or subject domains attached to the record.

insights[].entities
array<object> required

Assets and non-asset subjects linked to this record.
insights[].entities[].entity_id
string required

Canonical knowledge-graph identifier for the linked entity. Use /assets or /subjects to resolve request selectors.

insights[].entities[].entity_types
array<string> required

Knowledge-graph classifications for the linked entity.

insights[].entities[].is_direct
boolean required

True when the record directly concerns this linked entity.

insights[].entities[].is_primary
boolean required

True when this is the record's primary linked entity.

insights[].entities[].name
string required

Human-readable name.

insights[].entities[].role
string required

Relationship of the linked entity to the intelligence item.

insights[].headline
string required

Concise intelligence headline.

insights[].importance_score
integer required

Relative importance score from 1 to 10.

insights[].insight_id
integer (int64) required

Stable identifier for the intelligence item.

insights[].sentiment_score
integer required

Signed sentiment score; positive is bullish and negative is bearish.

insights[].start_time
string (date-time) optional

UTC time when the intelligence item or event starts.

insights[].summary
string required

Evidence-grounded summary of the intelligence item.

insights[].tags
array<string> required

Searchable labels attached to the record.

insights[].updated_at
string (date-time) optional

UTC time when the record was last updated.

{
  "insights": [
    {
      "category": "earnings",
      "domains": [
        "equities",
        "technology"
      ],
      "entities": [
        {
          "entity_id": "eq:NVDA",
          "entity_types": [
            "equity"
          ],
          "is_direct": true,
          "is_primary": true,
          "name": "NVIDIA Corporation",
          "role": "primary"
        }
      ],
      "headline": "NVIDIA raises its quarterly revenue outlook",
      "importance_score": 8,
      "insight_id": 38421,
      "sentiment_score": 61,
      "start_time": "2026-08-20T20:00:00Z",
      "summary": "Management raised guidance after stronger-than-expected data-centre demand.",
      "tags": [
        "earnings",
        "data_centres"
      ],
      "updated_at": "2026-08-07T14:35:00Z"
    }
  ]
}