全部文档 Nebula 文档 所有端点 交互式文档 Markdown OpenAPI JSON
  1. REST API
  2. 社交与情绪

相关主体

GET /related-subjects
GetRelatedSubjects

与某项资产或主题最常出现在同一批帖子中的人物、账号和话题。share 表示共同帖子占锚点帖子的比例；情感字段表示锚点在这些共同帖子中的情感。

参数规则：

  • 发送 asset_id 或 subject_id。
  • asset_id 必须与 asset_class 一起发送。
  • subject_id 不能与 asset_id 或 asset_class 组合使用。

钱包支付可通过 https://nebula-api.hiddensystems.ai/api/v1/x402/related-subjects 使用。无需 Nebula 账户或 API key；签名前请先查看支付报价。x402 支付指南。

参数

asset_id string QUERY

来自 /assets 或 /search 的资产 ID，例如 NVDA、GLD、SPX 或 bitcoin。请与随其一同返回的 asset_class 一起发送。

Example:NVDA

asset_class string QUERY

asset_id 所指资产的类别：equity（股票和 ETF）、commodity、index 或 crypto。请发送 /assets 或 /search 随 asset_id 一同返回的 asset_class。

允许的值
equitycommodityindexcrypto

Example:equity

subject_id string QUERY

由 /subjects 或 /search 返回的规范非资产标识符，例如 text:jensen huang 或 handle:elonmusk。不区分大小写。不能与 asset_id 或 asset_class 组合使用。

Example:text:jensen huang

hours integer QUERY

回溯窗口，以小时计。免费套餐可回溯 90 天；超出则返回 403。

Default:168

limit integer QUERY

返回的最大结果数。

Default:25

cURL 示例

curl --get \
  --url 'https://nebula-api.hiddensystems.ai/api/v1/public/related-subjects' \
  --data-urlencode 'asset_id=NVDA' \
  --data-urlencode 'asset_class=equity' \
  --header 'X-API-Key: YOUR_API_KEY'

响应

200 OK
400 错误请求
401 未授权
402 Credits 已用尽；响应中包含续期时间和已购买的 credit 余额
403 禁止访问
404 未找到
405 方法不被允许；Allow 响应头列出了支持的方法
429 请求过多
500 内部服务器错误
503 服务不可用

媒体类型 application/json

authors
integer (int64) 必填

匹配帖子所代表的不同作者数。

average_sentiment_score
number (double) 必填

所请求时间窗口内所有锚点帖子的平均情感得分。

from
string (date-time) 必填

所测量时间窗口的 UTC 起始时间（含）。

hours
integer 必填

响应所代表的回溯窗口，以小时为单位。

posts
integer (int64) 必填

所请求时间窗口内的匹配帖子数。

subjects
array<object> 必填

发现操作返回的非资产主题。
subjects[].authors
integer (int64) 必填

匹配帖子所代表的不同作者数。

subjects[].bearish_posts
integer (int64) 必填

被归类为看跌的帖子。

subjects[].bullish_posts
integer (int64) 必填

被归类为看涨的帖子。

subjects[].first_post_at
string (date-time) 可选

所请求时间窗口内第一条匹配帖子的 UTC 时间。

subjects[].last_post_at
string (date-time) 可选

所请求时间窗口内最新一条匹配帖子的 UTC 时间。

subjects[].name
string 必填

人类可读的名称。

subjects[].neutral_posts
integer (int64) 必填

被归类为中性的帖子。

subjects[].posts
integer (int64) 必填

所请求时间窗口内的匹配帖子数。

subjects[].posts_delta
number (double) 必填

从 posts_prior 到 posts_recent 的变化比例；正值表示增长。

subjects[].posts_prior
integer (int64) 必填

所请求时间窗口前半段的匹配帖子。

subjects[].posts_recent
integer (int64) 必填

所请求时间窗口后半段的匹配帖子。

subjects[].sentiment_delta
number (double) 必填

共同对话的 sentiment_score 与锚点全窗口平均值之间的差值。

subjects[].sentiment_score
number (double) 必填

带符号的情绪分数；正值为看涨，负值为看跌。

subjects[].share
number (double) 必填

同时提及该主题的锚点帖子占窗口内所有锚点帖子的小数比例。

subjects[].subject_id
string 必填

非资产的人物、账户或主题的规范标识符。

to
string (date-time) 必填

所测量时间窗口的 UTC 结束时间（不含）。

{
  "authors": 241,
  "average_sentiment_score": 36.2,
  "from": "2026-08-15T09:00:00Z",
  "hours": 168,
  "posts": 684,
  "subjects": [
    {
      "authors": 73,
      "bearish_posts": 41,
      "bullish_posts": 112,
      "first_post_at": "2026-08-15T09:00:00Z",
      "last_post_at": "2026-08-22T08:45:00Z",
      "name": "Artificial Intelligence",
      "neutral_posts": 31,
      "posts": 184,
      "posts_delta": 0.556,
      "posts_prior": 72,
      "posts_recent": 112,
      "sentiment_delta": 8.4,
      "sentiment_score": 42.6,
      "share": 0.148,
      "subject_id": "text:artificial intelligence"
    }
  ],
  "to": "2026-08-22T09:00:00Z"
}