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.
Discovery
3 endpoints/screener
Screener
Rank assets or subjects by one 24-hour measure and filter on the others: share, share change, posts, net bullish posts (bullish minus bearish; negative is bearish), or 24-hour price change. Ranges are inclusive and combine; price filters apply to assets only.
/top-momentum
Top momentum
The assets or subjects gaining share of the conversation fastest: this 24 hours' share minus the previous 24 hours'. share_change_pct is the same change relative to yesterday's share.
/top-trending
Top trending
The assets or subjects with the largest share of the conversation over the last 24 hours, highest first, with the change against the previous 24 hours.
Lookup
3 endpoints/assets
Text to asset ID
Look up equities (stocks and ETFs), commodities, indices, and crypto by name or ticker, and get the asset_id and asset_class every asset endpoint takes. Send query to search, asset_id for an exact match, or neither to browse the most active assets.
/search
Search
One search across assets, people, accounts, and topics. Each result's kind says which it is: assets carry asset_id and asset_class, subjects carry subject_id. Send kind to search one side only.
/subjects
Text to subject ID
Look up people, accounts, and topics, AI included, and get the subject_id the subject endpoints take. Assets are not included; use /assets or /search for those.
Social & Sentiment
6 endpoints/emotions
Emotion distribution
Which of 15 emotions dominate the conversation about an asset or subject over time. proportion is each emotion's share of the bucket's emotions (they add up to 1); post_count counts posts showing it. A post can show several.
/mindshare
Mindshare
An asset's or subject's share of the conversation: its posts over the trailing 24 hours as a fraction of all posts in its market (stocks, crypto, or people and topics), from 0 to 1. Send clusters to measure share within one or more author groups.
/related-subjects
Related subjects
The people, accounts, and topics most often discussed in the same posts as an asset or subject. share is shared posts as a fraction of the anchor's posts; the sentiment fields are the anchor's sentiment within those shared posts.
/sentiment
Sentiment
How bullish or bearish the conversation is about an asset, a subject, or a whole market, over time. sentiment_signal is bullish minus bearish posts over the trailing 24 hours, recent posts weighted more: positive is net bullish. It grows with volume, so compare an asset with its own history.
/sentiment/timeframes
Sentiment by timeframe
Sentiment split by the horizon people are talking about: short term (up to a week), medium term (weeks to months), and long term (three months or more), each on the /sentiment scale. Separates a crowd that is bearish this week but bullish on the year from one that is bearish throughout.
/social-momentum
Social momentum
Posts, unique posters, and sentiment inside each author cluster, side by side, for an asset, a subject, or a whole market: which groups are driving the conversation and how their tone differs. Clusters overlap, so do not add them together. Send clusters to return only the ones you name.
Forecasts
3 endpoints/forecasts/assets
Forecastable assets
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.
/forecasts/mindshare
Mindshare forecast
Where an asset's mindshare is likely to be over the next 72 hours, as a range of outcomes with their chances. series gives the distribution every 4 hours; chance_higher_72h and likely_low_share to likely_high_share summarise where it lands; takeoff_chance_72h is the chance of a sudden surge in attention.
/forecasts/sentiment
Sentiment forecast
Where an asset's sentiment is likely to go over the next 72 hours, as a range of outcomes with their chances. series gives, every 4 hours, the bullish, bearish, neutral, and total posts expected in that step and the sentiment_signal at its end, on the /sentiment scale. chance_higher_24h and chance_higher_72h give the chance the signal ends above current_sentiment_signal; their _confident flags mark when that chance leans clearly one way.
Market Sentiment
7 endpoints/calls
Long/short calls
How many long and short calls people are making on an asset, or across every market, over time. A call says an asset will rise or fall, discloses a position, or tells others to take one; plain opinion does not count. Send clusters to count one group's calls.
/calls/returns
Calls outcome distribution
How recent calls have performed: win rate, median and average return, and the distribution of returns. Each call is scored on the price move over the 24 hours after it, from the caller's side, so a short call on a 10% drop is +10%. Send clusters to compare groups, for example smart_money against dumb_money.
/conviction-index
Conviction index
A 0–100 reading of how strongly people believe in an asset. It combines the asset's bullish ratio against the market's, how far sentiment holds up while price falls, the latest bullish ratio, and greed-type emotions. Around 50 is typical; compare an asset with its own history.
/fear-greed-index
Fear and Greed index
A daily 0–100 fear-versus-greed reading for one asset, combining price, volatility, momentum, trading volume, and social mood: up to 20 Extreme Fear, 40 Fear, 60 Neutral, 80 Greed, above 80 Extreme Greed. metadata lists the components.
/price-levels
Socially mentioned price levels
The prices people name for an asset (targets, supports, and quoted levels), bucketed by price and time: where the crowd is anchoring its expectations. mentions counts stated levels, so one post can add several.
/social-volume-index
Social vs trading volume
Whether trading or conversation is running hotter for an asset, each measured against its own 90-day normal. volume_index runs 0–100: 50 means both are equally elevated, above 50 trading is ahead of the conversation, below 50 the conversation is ahead of trading. Daily, for up to 90 days.
/social-volume-profile
Social volume profile
A volume profile made of posts instead of trades: where on the price axis the conversation about an asset happened. Each bin has post counts, bullish and bearish shares, and directional_imbalance from −1 (all bearish) to +1 (all bullish); significance_score ranks the bins from 0 to 1 on posts, balance, how often price revisits them, and compression; the point of control is the busiest bin. Send clusters to profile one group.
Market Data
1 endpointsIntelligence
3 endpoints/calendar-events
Calendar events
Upcoming and past market events (earnings, economic releases, IPOs, listings, votes, hearings), globally or for one asset or subject, with type, status, importance from 1 to 3, and the entities involved. Defaults to today onward, earliest first; send min_importance_score=2 for the notable ones.
/insights
Intelligence
Short stories on what is happening in markets, globally or for one asset or subject, each with a headline, summary, sentiment (−1, 0, or +1), tags, importance from 1 to 3, and the entities involved. Most recently updated first; send order_by=start_time_desc for the newest events first.
/insights/attention
Insight attention
The conversation around one intelligence item: the 24-hour attention window, author and sentiment counts, hourly buckets, cluster mix, impact vectors, and price reactions for every priceable linked entity. Use this after /insights when a reader opens one item and needs the full drawer-level context.
Clusters
10 endpoints/clusters
Author clusters
Every author cluster's activity and sentiment in a market: posts, unique authors, change against the previous window, and net sentiment (bullish minus bearish posts) with an hourly series. asset_class is equity (the default) or crypto.
/clusters/comparison
Cluster comparison
Every author cluster side by side over the window: posts and their change, how bullish it is against the market (cluster_bullish_share against market_bullish_share), the asset it turned to most over the last 7 days (trending_asset), and daily posts.
/clusters/comparison/divisive-assets
Divisive assets
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.
/clusters/comparison/hype-cycles
Hype cycle arrivals
The window's biggest hype cycles and the order the clusters arrived in each, relative to the market's peak hour, with the market's hourly posts around the peak.
/clusters/comparison/traits
Cluster trait comparison
Every /clusters/profile trait across all clusters, highest first, to see which groups lead or trail on each.
/clusters/hype-cycles
Cluster hype cycles
How early one cluster arrives at hype cycles compared with the market. curve is the cumulative share of each side's posts from 7 days before a peak to 7 after, so the line further left is earlier; lead_days is the cluster's lead (positive is early), and clusters ranks every cluster's lead.
/clusters/overlap
Cluster overlap
Which clusters watch the same assets as this one, and whether they agree. overlap_share is how much of its top 50 assets a peer shares; direction_agreement_share is how often they lean the same way; stance_gap is positive when this cluster is the more bullish.
/clusters/profile
Cluster profile
One cluster's behavioural traits, each ranked against every other cluster (rank 1 is the highest):
/clusters/rotation
Cluster rotation
Where one cluster's attention is moving: the assets gaining and losing share of its posts against the previous window, in basis points, and how its posts split across markets, people, and events.
/clusters/stances
Cluster stances
One cluster's stance on its most-discussed assets beside the market's, from −1 (all bearish) to +1 (all bullish). contrarian_share is how often it leans the opposite way to the market, with the average across other clusters for comparison.
Agent
1 endpointsAccount
1 endpointsOther
3 endpoints/predictions
Prediction markets
Browse Polymarket and Kalshi contracts. Prices are outcome probabilities from each venue, not social sentiment. Volume retains its venue unit. Equivalent contracts share a market; related contracts remain separate. Subject metrics use the existing subject and asset endpoints.
/predictions/history
Prediction outcome history
Historical prices for one venue outcome, as fractions from 0 to 1. The series contains UTC timestamps and up to 1002 sampled observations, including available venue backfills. Each point identifies midpoint or provider price basis; provider history is not claimed to be a bid-ask midpoint. Points is retained as a deprecated compatibility mirror.
/predictions/market
Prediction market detail
Contract rules, outcomes, venue observations and linked identities for existing asset and subject analytics. Quotes retain bid, ask, midpoint and last-trade evidence separately; no combined market sentiment is inferred.