# Forecastable assets

- Method: `GET`
- Path: `/forecasts/assets`
- Credits: 1
- HTML docs: https://docs.hiddensystems.ai/nebula/reference/get-forecasts-assets/
- Interactive docs: https://docs.hiddensystems.ai/nebula/api/#endpoint=get-forecasts-assets

## Description

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.

## cURL Example

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

## Path Parameters

No path parameters for this endpoint.

## Query Parameters

- `asset_class` (string, optional, allowed: equity, commodity, index, crypto): Restricts the list to one class: equity (stocks and ETFs), commodity, index, or crypto.
- `limit` (integer, optional, default: 100, range: 1–1000): Maximum results returned.
- `offset` (integer, optional, default: 0, minimum: 0): Number of results skipped.

## Response

OK

- `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, enum: equity, commodity, index, crypto): The asset's class: equity (stocks and ETFs), commodity, index, or crypto. Send it with asset_id on every asset-scoped request.
- `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.

Media type: `application/json`

## JSON Response

```json
{
  "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
}
```