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

Forecastable assets

GET /forecasts/assets
ListForecastAssets

Every asset with a forecast right now. The list covers both /forecasts/mindshare and /forecasts/sentiment, which forecast the same assets: pass an asset's asset_id and asset_class to either. Stocks, commodities, and indices come first, then crypto, most-discussed first. The list updates every five minutes.

Parameters

asset_class string QUERY

Restricts the list to one class: equity (stocks and ETFs), commodity, index, or crypto.

Allowed values
equitycommodityindexcrypto

Example:equity

limit integer QUERY

Maximum results returned.

Default:100

offset integer QUERY

Number of results skipped.

Default:0

cURL Example

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

Responses

200 OK
400 Bad Request
401 Unauthorized
402 Credits used up; upgrade_url links to buying more
403 Forbidden
404 Not Found
405 Method not allowed; the Allow header lists the supported method
429 Too Many Requests
500 Internal Server Error
503 Service Unavailable

Media type application/json

assets
array<object> required

Assets with a current forecast: stocks, commodities, and indices first, then crypto; most-discussed first within each class.
assets[].as_of
string (date-time) required

UTC start of the asset's current forecast: the end of the last complete 15 minutes it was computed from.

assets[].asset_class
string required

The asset's class: equity (stocks and ETFs), commodity, index, or crypto. Send it with asset_id on every asset-scoped request.

Allowed values
equitycommodityindexcrypto
assets[].asset_id
string required

Canonical public asset identifier: the ticker or market symbol for stocks, commodities, and indices, and the CoinGecko slug (or, without one, a numeric id) for crypto.

assets[].name
string required

Human-readable name.

assets[].symbol
string required

Display ticker or market symbol.

has_more
boolean required

True when another page is available after the returned records.

limit
integer required

Maximum records requested.

offset
integer required

Number of matching records skipped.

total
integer required

How many assets match the request across every page.

{
  "assets": [
    {
      "as_of": "2026-09-14T14:15:00Z",
      "asset_class": "equity",
      "asset_id": "NVDA",
      "name": "NVIDIA Corporation",
      "symbol": "NVDA"
    },
    {
      "as_of": "2026-09-14T14:15:00Z",
      "asset_class": "equity",
      "asset_id": "TSLA",
      "name": "Tesla, Inc.",
      "symbol": "TSLA"
    },
    {
      "as_of": "2026-09-14T14:15:00Z",
      "asset_class": "equity",
      "asset_id": "AMZN",
      "name": "Amazon.com, Inc.",
      "symbol": "AMZN"
    }
  ],
  "has_more": true,
  "limit": 100,
  "offset": 0,
  "total": 3206
}