# Assets in an author cluster

- Method: `GET`
- Path: `/clusters/{cluster_id}/assets`
- Tier: Pro
- HTML docs: https://docs.hiddensystems.ai/nebula/reference/get-clusters-cluster-id-assets/
- Interactive docs: https://docs.hiddensystems.ai/nebula/api/#endpoint=get-clusters-cluster-id-assets

## Description

Returns assets ranked by post activity within one canonical author cluster and one required asset class. Equity results can include stocks, commodities, and indices.

## cURL Example

```bash
curl --get \
  --url 'https://nebula-api.hiddensystems.ai/api/v1/public/clusters/smart_money/assets' \
  --data-urlencode 'asset_class=equity' \
  --header 'X-API-Key: YOUR_API_KEY'
```

## Path Parameters

- `cluster_id` (string, required): Cluster identifier.

## Query Parameters

- `asset_class` (string, required, allowed: equity, crypto): 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.
- `hours` (integer, optional, default: 24): Lookback window in hours.
- `limit` (integer, optional, default: 40): Maximum results returned.

## Response

OK

- `assets` (array<object>, required): Assets matching the supplied discovery filters.
- `assets[].asset_class` (string, required): Market class that namespaces the asset identifier.
- `assets[].asset_id` (string, required): Canonical public asset identifier. Equity identifiers are ticker symbols; crypto identifiers are canonical crypto IDs.
- `assets[].bearish_posts` (number (double), required): Posts classified as bearish.
- `assets[].bullish_posts` (number (double), required): Posts classified as bullish.
- `assets[].name` (string, required): Human-readable name.
- `assets[].neutral_posts` (number (double), required): Posts classified as neutral.
- `assets[].sentiment_signal` (number (double), required): Decay-weighted net bullish posts: bullish minus bearish. Positive is bullish, negative is bearish, and magnitude grows with activity.
- `assets[].symbol` (string, required): Display ticker or market symbol.
- `assets[].total_posts` (number (double), required): Post count over the metric's active lookback window.
- `cluster` (string, required): Canonical author-cluster identifier.
- `hours` (integer, required): Lookback window represented by the response, in hours.
- `total_posts` (number (double), required): Post count over the metric's active lookback window.

Media type: `application/json`

## JSON Response

```json
{
  "assets": [
    {
      "asset_class": "equity",
      "asset_id": "NVDA",
      "bearish_posts": 438,
      "bullish_posts": 1120,
      "name": "NVIDIA Corporation",
      "neutral_posts": 284,
      "sentiment_signal": 128.6,
      "symbol": "NVDA",
      "total_posts": 1842
    }
  ],
  "cluster": "smart_money",
  "hours": 168,
  "total_posts": 1842
}
```