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

Divisive assets

GET /clusters/comparison/divisive-assets
GetDivisiveAssets

The widely discussed assets the clusters disagree on most. minority_share is the smaller camp's share of the clusters leaning clearly bullish or bearish, so 0.5 is an even split. It measures divided conversation, not a coming move.

Wallet payment available at https://nebula-api.hiddensystems.ai/api/v1/x402/clusters/comparison/divisive-assets. No Nebula account or API key required; check the payment offer before signing. x402 payment guide.

Parameters

asset_class array<string> QUERY

The markets to compare across: any of equity, commodity, index, and crypto, comma-separated. Defaults to all four. Send several comma-separated.

Default:equity,commodity,index,crypto

days integer QUERY

How many complete UTC days to measure stances over, counting back from the latest complete day: 7, 30, or 90. Free plans reach back 90 days; further returns 403.

Allowed values
73090

Default:30

limit integer QUERY

Maximum assets returned.

Default:10

cURL Example

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

Responses

200 OK
400 Bad Request
401 Unauthorized
402 Credits used up; response includes renewal timing and purchased credit balance
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

asset_classes
array<string> required

The markets analysed, in the order equity, commodity, index, crypto: the asset_class values requested, or all four when asset_class was omitted.

assets
array<object> required

The divisive assets, most evenly split first, up to limit.
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[].bearish_cluster_count
integer required

Clusters leaning bearish on the asset by 0.1 or more.

assets[].bullish_cluster_count
integer required

Clusters leaning bullish on the asset by 0.1 or more.

assets[].cluster_stances
array<object> required

Every cluster with a stance on the asset (8 or more bullish or bearish posts), most bearish first.
assets[].cluster_stances[].cluster_id
string required

Canonical author-cluster identifier.

assets[].cluster_stances[].posts
integer (int64) required

The cluster's posts on the asset over the window.

assets[].cluster_stances[].stance
number (double) required

The cluster's net stance on the asset: (bullish − bearish) ÷ (bullish + bearish) posts, from −1 to +1.

assets[].market_stance
number (double) required

The market's net stance on the same asset over the same window, on the same −1 to +1 scale, from every author except bots.

assets[].minority_share
number (double) required

The smaller side's share of the clusters leaning clearly bullish or bearish (0.1 or more either way), from 0 (all one way) to 0.5 (an even split). Assets are ranked by it.

assets[].name
string required

Human-readable name.

assets[].stance_iqr
number (double) required

The interquartile range of the clusters' stances, from 0 to 2: how far apart the middle half of the clusters sit. Breaks ties in minority_share.

assets[].symbol
string required

Display ticker or market symbol.

days
integer required

Window length in complete UTC days, ending at the latest complete day.

{
  "asset_classes": [
    "equity",
    "commodity",
    "index",
    "crypto"
  ],
  "assets": [
    {
      "asset_class": "equity",
      "asset_id": "WMT",
      "bearish_cluster_count": 14,
      "bullish_cluster_count": 5,
      "cluster_stances": [
        {
          "cluster_id": "policy_political",
          "posts": 64,
          "stance": -0.58
        },
        {
          "cluster_id": "media",
          "posts": 311,
          "stance": -0.21
        },
        {
          "cluster_id": "automated_ai",
          "posts": 28,
          "stance": 0.75
        }
      ],
      "market_stance": -0.17,
      "minority_share": 0.2632,
      "name": "Walmart Inc.",
      "stance_iqr": 0.6125,
      "symbol": "WMT"
    }
  ],
  "days": 30
}