情绪
/sentiment
关于某项资产、某个主题或整个市场的讨论随时间变化的看涨或看跌程度。sentiment_signal 是过去 24 小时内看涨帖子减去看跌帖子,近期帖子权重更高:正值表示净看涨。它会随发帖量增长,因此请将资产与其自身历史进行比较。
cohorts 为机器人和(针对单项资产或主题的)顶级喊单者提供相同的度量。发送 clusters 可读取一个或多个作者群体,或省略资产和主题以获取全市场视图。
参数规则:
asset_id必须与asset_class一起发送。subject_id不能与asset_id或asset_class组合使用。- 不使用
asset_id时,asset_class必须为equity或crypto;commodity和index需要asset_id。
钱包支付可通过 https://nebula-api.hiddensystems.ai/api/v1/x402/sentiment 使用。无需 Nebula 账户或 API key;签名前请先查看支付报价。x402 支付指南。
参数
来自 /assets 或 /search 的资产 ID,例如 NVDA、GLD、SPX 或 bitcoin。请与随其一同返回的 asset_class 一起发送。
Example:NVDA
与 asset_id 一起使用时,表示资产的类别。不使用时,表示要聚合的市场:equity(股票、大宗商品和指数;默认值)或 crypto。
equitycommodityindexcrypto
Example:equity
由 /subjects 或 /search 返回的规范非资产标识符,例如 text:jensen huang 或 handle:elonmusk。不区分大小写。不能与 asset_id 或 asset_class 组合使用。
Example:text:jensen huang
回溯窗口,以小时计。免费套餐可回溯 90 天;超出则返回 403。
Default:168
请求的时间序列桶大小。省略时,服务会根据回溯窗口选择合适的桶大小。
1h2h4h12h1d
Example:1h
要读取的作者集群;重复传入可组合,例如 clusters=kols&clusters=media。所选集群会合并计算,一个作者可以属于多个集群。
- Callers:
smart_money(表现最好的 caller)、dumb_money(表现最差的)、top_degens(小市值加密货币上表现最好的) - Timing:
early_movers(在关注度上升时最先谈论某资产)、late_movers(在峰值时或之后才入场) - Builders:
developers、founders、team_leaders、project_accounts - Institutions:
vcs、asset_managers、dao_guild_funds、incubators、exchanges - Influence:
kols、celebrities、media、marketer、shiller - Analysts:
ta_analyst、fa_analyst、macro_analyst、onchain_analyst、investigators - Traders:
position_trader、swing_trader、day_trader - Bias:
perma_bull、doomer、tribalist - Other:
political、nft、bots、automated_ai - Communities,按发帖位置划分:
wallstreetbets、reddit
Example:smart_money
cURL 示例
curl --request GET \
--url 'https://nebula-api.hiddensystems.ai/api/v1/public/sentiment' \
--header 'X-API-Key: YOUR_API_KEY'
响应
媒体类型 application/json
cohorts
object
其他作者群体的相同度量:bots,以及在该群体可用时的 top_callers。非机器人群体即 series 本身。
允许的键
botstop_callers
cohorts
其他作者群体的相同度量:bots,以及在该群体可用时的 top_callers。非机器人群体即 series 本身。
botstop_callers
cohorts.{key}[].bearish_posts
截至该时间点的过去 24 小时内的看跌帖子数;interval_bearish_posts 为该桶内的数量。
cohorts.{key}[].bullish_posts
截至该时间点的过去 24 小时内的看涨帖子数;interval_bullish_posts 为该桶内的数量。
cohorts.{key}[].interval_bearish_posts
该输出时间桶内的看跌帖子数。
cohorts.{key}[].interval_bullish_posts
该输出时间桶内的看涨帖子数。
cohorts.{key}[].interval_neutral_posts
该输出时间桶内的中性帖子数。
cohorts.{key}[].interval_posts
该输出时间桶内的帖子数,尚未进行回溯累积。
cohorts.{key}[].neutral_posts
截至该时间点的过去 24 小时内的中性帖子数;interval_neutral_posts 为该桶内的数量。
cohorts.{key}[].sentiment_signal
衰减加权的净看涨帖子数:看涨减去看跌。正值表示看涨,负值表示看跌,且幅度随活跃度增长。
cohorts.{key}[].timestamp
观测值或桶起始时间的 UTC RFC 3339 时间戳。
cohorts.{key}[].total_posts
截至该时间点的过去 24 小时内的帖子数,而非仅该桶;interval_posts 为该桶内的数量。
series
array<object>
按时间顺序排列的观测值。
series
按时间顺序排列的观测值。
series[].bearish_posts
截至该时间点的过去 24 小时内的看跌帖子数;interval_bearish_posts 为该桶内的数量。
series[].bullish_posts
截至该时间点的过去 24 小时内的看涨帖子数;interval_bullish_posts 为该桶内的数量。
series[].interval_bearish_posts
该输出时间桶内的看跌帖子数。
series[].interval_bullish_posts
该输出时间桶内的看涨帖子数。
series[].interval_neutral_posts
该输出时间桶内的中性帖子数。
series[].interval_posts
该输出时间桶内的帖子数,尚未进行回溯累积。
series[].neutral_posts
截至该时间点的过去 24 小时内的中性帖子数;interval_neutral_posts 为该桶内的数量。
series[].sentiment_signal
衰减加权的净看涨帖子数:看涨减去看跌。正值表示看涨,负值表示看跌,且幅度随活跃度增长。
series[].timestamp
观测值或桶起始时间的 UTC RFC 3339 时间戳。
series[].total_posts
截至该时间点的过去 24 小时内的帖子数,而非仅该桶;interval_posts 为该桶内的数量。
{
"cohorts": {
"bots": [
{
"bearish_posts": 438,
"bullish_posts": 1120,
"neutral_posts": 284,
"sentiment_signal": 128.6,
"timestamp": "2026-08-07T15:00:00Z",
"total_posts": 1842
}
]
},
"series": [
{
"bearish_posts": 438,
"bullish_posts": 1120,
"interval_bearish_posts": 18,
"interval_bullish_posts": 46,
"interval_neutral_posts": 10,
"interval_posts": 74,
"neutral_posts": 284,
"sentiment_signal": 128.6,
"timestamp": "2026-08-07T15:00:00Z",
"total_posts": 1842
}
]
}