Nebula 公共 API
参考索引
以下每个端点都有稳定的 HTML 页面和对应的 Markdown 版本。本索引为静态内容，可被爬取，AI 智能体无需执行 JavaScript 即可安全读取。
发现
3 个端点/screener
筛选器
按某一 24 小时指标对资产或主体排序，并用其他指标进行筛选：share、share change、posts、net bullish posts（bullish 减去 bearish；负值表示 bearish）或 24 小时价格变化。范围均为闭区间且可组合使用；价格筛选仅适用于资产。
/top-momentum
动量榜
对话份额增长最快的资产或主体：本 24 小时的 share 减去前 24 小时的 share。share_change_pct 是相对于昨日 share 的同一变化。
/top-trending
热门趋势
过去 24 小时内讨论热度占比最高的资产或主题，按占比从高到低排列，并附上与上一个 24 小时的对比变化。
查询
3 个端点/assets
文本转资产 ID
按名称或 ticker 查找股票（stocks 和 ETFs）、大宗商品、指数和加密货币，并获取每个资产端点都接受的 asset_id 和 asset_class。发送 query 进行搜索，发送 asset_id 进行精确匹配，或两者都不发送以浏览最活跃的资产。
/search
搜索
一次搜索即可覆盖资产、人物、账户和话题。每条结果的 kind 会标明其类型：资产带有 asset_id 和 asset_class，主体带有 subject_id。发送 kind 可只搜索其中一侧。
/subjects
文本转主体 ID
查找人物、账号和话题（包括 AI），并获取主体端点都接受的 subject_id。不包含资产；请使用 /assets 或 /search 查找资产。
社交与情绪
6 个端点/emotions
情绪分布
15 种情绪中哪些在一段时间内主导了关于某资产或主体的对话。proportion 是每种情绪在该时间桶情绪中的占比（合计为 1）；post_count 统计显示该情绪的发帖数。一条帖子可以显示多种情绪。
/mindshare
心智份额
某项资产或主体在讨论中所占的份额：其过去 24 小时内的帖子数占其所属市场（股票、加密货币，或人物与话题）全部帖子的比例，取值 0 到 1。发送 clusters 可衡量一个或多个作者分组内的份额。
/related-subjects
相关主体
与某项资产或主题最常出现在同一批帖子中的人物、账号和话题。share 表示共同帖子占锚点帖子的比例；情感字段表示锚点在这些共同帖子中的情感。
/sentiment
情绪
关于某项资产、某个主题或整个市场的讨论随时间变化的看涨或看跌程度。sentiment_signal 是过去 24 小时内看涨帖子减去看跌帖子，近期帖子权重更高：正值表示净看涨。它会随发帖量增长，因此请将资产与其自身历史进行比较。
/sentiment/timeframes
分时段情绪
按人们谈论的时间跨度拆分的情感：短期（最多一周）、中期（数周到数月）和长期（三个月及以上），均采用 /sentiment 的刻度。可区分本周看跌但全年看涨的人群与始终看跌的人群。
/social-momentum
社交动能
针对某项资产、某个主题或整个市场，并排展示每个作者聚类中的帖子、独立发帖者和情感：哪些群体在推动对话，以及他们的语气有何不同。聚类之间会重叠，因此不要将它们相加。发送 clusters 可仅返回你指定的聚类。
预测
3 个端点/forecasts/assets
可预测资产
当前有预测的所有资产。该列表涵盖 /forecasts/mindshare 和 /forecasts/sentiment，二者预测相同的资产：将资产的 asset_id 和 asset_class 传给任一接口即可。股票、大宗商品和指数排在前，然后是加密货币，按讨论热度从高到低排列。该列表每五分钟更新一次。
/forecasts/mindshare
心智份额预测
某项资产的 mindshare 在未来 72 小时内可能的走向，以结果范围及其概率表示。series 给出每 4 小时的分布；chance_higher_72h 和 likely_low_share 到 likely_high_share 概括其落点；takeoff_chance_72h 是关注度突然激增的概率。
/forecasts/sentiment
情绪预测
资产情绪在未来 72 小时内可能的走向，以结果区间及其概率表示。series 给出每 4 小时该步预期的看涨、看跌、中性及总帖子数，以及该步结束时的 sentiment_signal，均基于 /sentiment 量表。chance_higher_24h 和 chance_higher_72h 给出信号最终高于 current_sentiment_signal 的概率；它们的 _confident 标志表示该概率明显偏向某一方向。
市场情绪
7 个端点/calls
多空喊单
人们在一段时间内对某项资产或整个市场做出的多头和空头喊单数量。喊单是指声称某资产将上涨或下跌、披露持仓，或告诉他人建仓；单纯的观点不算。发送 clusters 可统计某一群体的喊单。
/calls/returns
喊单结果分布
近期喊单的表现：胜率、收益率中位数和平均值，以及收益率分布。每条喊单按其发出后 24 小时内的价格变动、从喊单者一侧计分，因此对下跌 10% 的空头喊单记为 +10%。发送 clusters 可比较不同群体，例如将 smart_money 与 dumb_money 对比。
/conviction-index
信念指数
衡量人们对某项资产看涨信念强度的 0–100 读数。它综合了该资产相对于市场的看涨比例、价格下跌时情绪的维持程度、最新看涨比例以及贪婪类情绪。通常约为 50；请将资产与其自身历史进行比较。
/fear-greed-index
恐惧与贪婪指数
针对单个资产的每日 0–100 恐惧与贪婪读数，综合价格、波动率、动量、交易量和社交情绪：最高 20 为极度恐惧，40 为恐惧，60 为中性，80 为贪婪，高于 80 为极度贪婪。metadata 列出了各组成部分。
/price-levels
社交提及价格位
人们为某项资产报出的价格（目标价、支撑位和报价水平），按价格和时间分桶：人群预期锚定在哪里。mentions 统计的是被提及的水平，因此一条帖子可能贡献多个。
/social-volume-index
社交量与交易量对比
某项资产的交易或讨论哪个更火热，二者均以各自的 90 天常态为基准衡量。volume_index 取值 0–100：50 表示二者升温程度相同，高于 50 表示交易领先于讨论，低于 50 表示讨论领先于交易。按日计算，最多 90 天。
/social-volume-profile
社交量分布
由帖子而非成交构成的成交量分布：关于某项资产的讨论发生在价格轴上的哪些位置。每个分箱包含帖子数、看涨与看跌占比，以及 directional_imbalance，取值从 −1（全部看跌）到 +1（全部看涨）；significance_score 依据帖子数、均衡度、价格回访该位置的频率以及压缩程度对分箱进行 0 到 1 的排名；控制点即最活跃的分箱。发送 clusters 可对单个分组进行剖析。
市场数据
1 个端点情报
3 个端点/calendar-events
日历事件
即将发生和已发生的市场事件（财报、经济数据发布、IPO、上市、投票、听证会），可按全球范围或单个资产或主题查询，包含类型、状态、1 至 3 的重要性以及涉及的实体。默认从今天起，最早优先；发送 min_importance_score=2 可仅获取值得关注的事件。
/insights
情报
关于市场动态的简短资讯，覆盖全球或某项资产或主体，每条包含标题、摘要、情绪（−1、0 或 +1）、标签、1 到 3 的重要程度，以及涉及的实体。按最近更新排序；发送 order_by=start_time_desc 可让最新事件排在最前。
/insights/attention
洞察关注度
围绕单条情报的对话：24 小时关注窗口、作者与情绪计数、按小时分桶、集群构成、影响向量，以及每个可定价关联实体的价格反应。当读者打开某条情报、需要抽屉级别的完整上下文时，在 /insights 之后使用。
聚类
10 个端点/clusters
作者聚类
每个作者集群在某个市场中的活跃度与情绪：帖子数、独立作者数、相对上一窗口的变化，以及净情绪（看涨帖子减看跌帖子）及小时级序列。asset_class 为 equity（默认）或 crypto。
/clusters/comparison
聚类对比
在窗口内并排比较每个作者集群：帖子数及其变化、相对市场的看涨程度（cluster_bullish_share 对 market_bullish_share）、过去 7 天最常转向的资产（trending_asset），以及每日帖子数。
/clusters/comparison/divisive-assets
分歧资产
各集群分歧最大的热门讨论资产。minority_share 是倾向明确看涨或看跌的集群中较小一方的占比，因此 0.5 表示势均力敌。它衡量的是讨论的分裂程度，而非即将发生的行情。
/clusters/comparison/hype-cycles
炒作周期到达
窗口内最大的炒作周期，以及各集群在每个周期中相对市场峰值小时的到达顺序，并附上峰值前后市场的逐小时帖子数。
/clusters/comparison/traits
聚类特征对比
所有集群的每个 /clusters/profile 特征，按从高到低排列，用于查看哪些群体在各项特征上领先或落后。
/clusters/hype-cycles
聚类炒作周期
某个集群相对于市场在热度周期中提前到达的程度。curve 是双方在峰值前 7 天到峰值后 7 天内的帖子累计占比，因此线条越靠左表示越早；lead_days 是该集群的领先天数（正值表示提前），clusters 则对所有集群的领先天数进行排名。
/clusters/overlap
聚类重叠
哪些集群关注与该集群相同的资产，以及它们是否一致。overlap_share 是同类集群与其前 50 个资产的重合比例；direction_agreement_share 是它们倾向相同的频率；stance_gap 为正表示该集群更看涨。
/clusters/profile
聚类画像
某个集群的行为特征，每项均相对于所有其他集群排名（rank 1 为最高）：
/clusters/rotation
聚类轮动
某个聚类的关注点正在如何转移：与上一窗口相比，在其帖子中占比上升和下降的资产（以基点计），以及其帖子在市场、人物和事件之间的分布。
/clusters/stances
聚类立场
某个聚类对其讨论最多的资产所持立场，与市场立场并列，从 −1（全部看跌）到 +1（全部看涨）。contrarian_share 是它与市场倾向相反的频率，并附其他聚类的平均值以供比较。