Assets in an author cluster

GET /clusters/{cluster_id}/assets
ListClusterAssets

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

Parameters

cluster_id string PATH required

Cluster identifier.

Example:smart_money

asset_class string QUERY required

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

hours integer QUERY

Lookback window in hours.

Default:24

limit integer QUERY

Maximum results returned.

Default:40

cURL Example

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'

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

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.

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