Nebula Public API
Reference index
Every endpoint below has a stable HTML page and a Markdown twin. This index is static, crawlable, and safe for AI agents to read without executing JavaScript.
Utility
2 endpoints/assets
Equities, commodities, indices & crypto
Discovers equities, commodities, indices, and crypto assets and returns the identifiers accepted by asset-scoped endpoints. Commodity and index instruments use asset_class=equity and expose asset_category for classification. Filter them with asset_category without asset_class. With no filter, results preserve the documented asset-class order: equity, then crypto. Supply query for search or asset_id for exact resolution; asset_id always requires asset_class. Parameter rules: asset_class and asset_category cannot be combined. asset_id and query cannot be combined. asset_id requires asset_class.
/subjects
Subjects
Discovers non-asset people, accounts, and topics, including AI-related subjects, and returns canonical subject_id values accepted by subject-aware endpoints. Assets and tickers are deliberately excluded; use /assets for them. Search uses the same canonical names, aliases, merge resolution, and ranking as Nebula's internal subject resolver. Supply query for search or subject_id for exact resolution. Parameter rules: subject_id and query cannot be combined.
Market data
5 endpoints/price-history
Price history
Returns market-price observations and a separate daily trading-volume series for one resolved asset. Trading volume is measured in shares for equities and USD for crypto. Asset selectors support equities, commodities, indices, and crypto assets returned by GET /assets; commodity and index IDs use asset_class=equity.
/price-levels
Socially mentioned price levels
Returns price levels extracted from social posts for one resolved asset, grouped into time and USD-price buckets with mention counts. Asset selectors support equities, commodities, indices, and crypto assets returned by GET /assets; commodity and index IDs use asset_class=equity.
/social-volume-profile
Social volume profile
Returns social post activity distributed across the prices at which one resolved asset traded. Each bin includes sentiment imbalance, revisit count, balance, compression, significance, and point-of-control status. Asset selectors support equities, commodities, indices, and crypto assets returned by GET /assets; commodity and index IDs use asset_class=equity.
/trading-volume
Trading volume
Returns trading-volume observations for one resolved asset. The response declares whether values are shares (equity) or USD (crypto). Asset selectors support equities, commodities, indices, and crypto assets returned by GET /assets; commodity and index IDs use asset_class=equity.
/volatility
Volatility
Returns the daily 30-observation rolling volatility series for one resolved asset, expressed in percentage points. Only granularity=1d is supported. Asset selectors support equities, commodities, indices, and crypto assets returned by GET /assets; commodity and index IDs use asset_class=equity.
Sentiment
7 endpoints/conviction-index
Conviction index
Returns Nebula's 0–100 community-conviction index for one resolved asset. Asset selectors support equities, commodities, indices, and crypto assets returned by GET /assets; commodity and index IDs use asset_class=equity.
/emotions
Emotion distribution
Returns post counts and within-bucket proportions for each detected emotion for exactly one resolved asset or non-asset subject. Asset selectors support equities, commodities, indices, and crypto assets returned by GET /assets; commodity and index IDs use asset_class=equity. Parameter rules: One of asset_id or subject_id is required. asset_id requires asset_class. subject_id and asset_class cannot be combined. subject_id and asset_id cannot be combined.
/fear-greed-index
Asset Fear and Greed index
Returns Nebula's 0–100 Fear and Greed series, current reading, labels, and component methodology for one resolved asset. Asset selectors support equities, commodities, indices, and crypto assets returned by GET /assets; commodity and index IDs use asset_class=equity.
/mindshare
Mindshare
Returns the share of eligible social attention for exactly one resolved asset or non-asset subject. Values are decimal fractions from 0 to 1. Restricting results to selected author clusters requires Pro. Asset selectors support equities, commodities, indices, and crypto assets returned by GET /assets; commodity and index IDs use asset_class=equity. Parameter rules: One of asset_id or subject_id is required. asset_id requires asset_class. subject_id and asset_class cannot be combined. subject_id and asset_id cannot be combined.
/sentiment
Sentiment
Returns Nebula's primary sentiment series for one asset, one non-asset subject, or a market-wide asset class. Free receives the high-level series; named cohort breakdowns and cluster filtering require Pro. Omit identity selectors for the global view; asset_class then defaults to equity. Asset selectors support equities, commodities, indices, and crypto assets returned by GET /assets; commodity and index IDs use asset_class=equity. Parameter rules: asset_id requires asset_class. subject_id and asset_class cannot be combined. subject_id and asset_id cannot be combined.
/sentiment/timeframes
Sentiment by timeframe
Returns short-, medium-, and long-horizon sentiment series and current readings for exactly one resolved asset or non-asset subject. Asset selectors support equities, commodities, indices, and crypto assets returned by GET /assets; commodity and index IDs use asset_class=equity. Parameter rules: One of asset_id or subject_id is required. asset_id requires asset_class. subject_id and asset_class cannot be combined. subject_id and asset_id cannot be combined.
/social-momentum
Social momentum
Returns post activity, unique posters, sentiment counts, and average sentiment over time, grouped by author cluster. Omit identity selectors for the global view; asset_class then defaults to equity. Asset selectors support equities, commodities, indices, and crypto assets returned by GET /assets; commodity and index IDs use asset_class=equity. Parameter rules: asset_id requires asset_class. subject_id and asset_class cannot be combined. subject_id and asset_id cannot be combined.
Calls
3 endpoints/calls
Call activity
Returns long and short call counts over time for one resolved asset. Omit both asset_id and asset_class for the all-market global view; asset_class cannot be used alone. Asset selectors support equities, commodities, indices, and crypto assets returned by GET /assets; commodity and index IDs use asset_class=equity. Parameter rules: asset_class requires asset_id. asset_id requires asset_class.
/calls/returns
Call returns
Returns resolved call performance and a direction-aligned return distribution for one resolved asset. Omit both asset_id and asset_class for the all-market global view; asset_class cannot be used alone. Asset selectors support equities, commodities, indices, and crypto assets returned by GET /assets; commodity and index IDs use asset_class=equity. Parameter rules: asset_class requires asset_id. asset_id requires asset_class.
/notable-calls
Notable calls
Returns ranked source posts containing notable long or short calls for one resolved asset, including entry price, direction-aligned performance, outcome, and source attribution. Asset selectors support equities, commodities, indices, and crypto assets returned by GET /assets; commodity and index IDs use asset_class=equity.
Intelligence
3 endpoints/calendar-events
Calendar events
Returns market events globally or for exactly one resolved asset or non-asset subject. By default, the global response starts at the current UTC day; use time bounds to request history. Asset selectors support equities, commodities, indices, and crypto assets returned by GET /assets; commodity and index IDs use asset_class=equity. Parameter rules: asset_class requires asset_id. asset_id requires asset_class. subject_id and asset_class cannot be combined. subject_id and asset_id cannot be combined.
/insights
Intelligence
Returns curated intelligence globally or for exactly one resolved asset or non-asset subject. The unscoped response spans all supported asset classes and subjects. Asset selectors support equities, commodities, indices, and crypto assets returned by GET /assets; commodity and index IDs use asset_class=equity. Parameter rules: asset_class requires asset_id. asset_id requires asset_class. subject_id and asset_class cannot be combined. subject_id and asset_id cannot be combined.
/related-subjects
Related subjects
Returns the non-asset subjects most frequently discussed in the same posts as exactly one resolved asset or non-asset subject. Each row includes shared activity and the anchor's sentiment within that conversation. Asset selectors support equities, commodities, indices, and crypto assets returned by GET /assets; commodity and index IDs use asset_class=equity. Parameter rules: One of asset_id or subject_id is required. asset_id requires asset_class. subject_id and asset_class cannot be combined. subject_id and asset_id cannot be combined.
Clusters
2 endpoints/clusters
Author clusters
Returns social activity, author counts, activity change, and sentiment grouped by author cluster for one asset class. Defaults to equity when asset_class is omitted.
/clusters/:cluster_id/assets
Assets in an author cluster
Returns assets ranked by post activity within one canonical author cluster and one required asset class. Equity results can include stocks, commodities, and indices.