熱門趨勢

GET /top-trending
GetTopTrending

過去 24 小時內討論熱度占比最高的資產或主體,由高至低排序,並附上與前一個 24 小時相比的變化。

占比是指在同一個市場、同一段 24 小時內所有貼文中所占的比例(股票、加密貨幣,或人物與主題),已排除機器人;加上 clusters 時,則是指這些叢集所發布內容的占比。

參數規則:

  • asset_class 僅適用於 kind=asset。
  • 僅在 kind=asset 為 asset_class equity、commodity 或 index 時,才接受 wallstreetbets 這類發布社群。

可使用錢包於 https://nebula-api.hiddensystems.ai/api/v1/x402/top-trending 付款。不需要 Nebula 帳號或 API 金鑰;簽署前請先確認付款條件。x402 付款指南。

參數

kind string QUERY

要排名的對象:asset(股票、大宗商品、指數或加密貨幣)或 subject(人物、帳號與主題)。預設為 asset。

允許的值
assetsubject

Default:asset

asset_class string QUERY

當 kind=asset 時,要排名的市場:equity(預設)、commodity、index 或 crypto。

允許的值
equitycommodityindexcrypto

Default:equity

clusters array<string> QUERY

要讀取的作者叢集;可重複指定以合併,例如 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

limit integer QUERY

傳回的結果數量上限。

Default:25

cURL 範例

curl --request GET \
  --url 'https://nebula-api.hiddensystems.ai/api/v1/public/top-trending' \
  --header 'X-API-Key: YOUR_API_KEY'

回應

200 OK
400 錯誤的要求
401 未經授權
402 額度已用完;回應會包含續約時間與已購買的額度餘額
403 禁止
404 找不到
405 不允許的方法;Allow 標頭會列出支援的方法
429 要求過多
500 內部伺服器錯誤
503 服務無法使用

媒體類型 application/json

asset_class
string 選填

資產所屬的市場;主體則不會有此欄位。

clusters
array<string> 必填

計入貼文的作者叢集,已正規化;若計入的是除了機器人以外的所有作者,則為空。

from
string (date-time) 必填

排名 24 小時區間的 UTC 開始時間。比較區間為其之前的 24 小時。

kind
string 必填

排名的對象:依要求為資產或主體。

允許的值
assetsubject
previous_total_posts
integer (int64) 必填

排名母體在過去 24 小時內的所有貼文。

results
array<object> 必填

排名結果,最佳者在前。

results[].asset_class
string 選填

資產的類別:equity(股票與 ETF)、commodity、index 或 crypto。請在每個以資產為範圍的要求中,與 asset_id 一併送出。

允許的值
equitycommodityindexcrypto
results[].asset_id
string 選填

標準的公開資產識別碼:股票、商品與指數為 ticker 或市場代號,crypto 則為 CoinGecko slug(若無 slug,則為數字 id)。

results[].bearish_posts
integer (int64) 必填

歸類為看跌的貼文。

results[].bullish_posts
integer (int64) 必填

歸類為看漲的貼文。

results[].kind
string 必填

結果的類型:asset(以 asset_id 和 asset_class 查詢)或 subject(以 subject_id 查詢)。

允許的值
assetsubject
results[].name
string 必填

人類可讀的名稱。

results[].neutral_posts
integer (int64) 必填

歸類為中性的貼文。

results[].posts
integer (int64) 必填

此結果在排名 24 小時區間內的貼文。

results[].previous_posts
integer (int64) 必填

此結果在緊接之前、長度相同之區間內的貼文。

results[].price_change_24h_pct
number (double) 選填

24 小時內的原始市場價格變動,以百分點為單位。

results[].share
number (double) 必填

此結果的貼文在排名母體同一 24 小時內所有貼文中所占的比例,介於 0 到 1。

results[].share_change
number (double) 選填

占比相較於前一區間的變化,以小數表示:0.01 代表一個百分點。僅在母體於前一區間沒有任何貼文時才會缺少。

results[].share_change_pct
number (double) 選填

占比相對於前一區間占比的變化,以百分比表示。當此結果在前一區間沒有貼文時會缺少。

results[].subject_id
string 選填

非資產的人物、帳號或主題的標準識別碼。

results[].symbol
string 選填

顯示用的 ticker 或市場代號。

to
string (date-time) 必填

排名 24 小時區間的 UTC 結束時間:即計算排名的時間。

total_posts
integer (int64) 必填

排名母體在該 24 小時內的所有貼文:占比的分母。

{
  "asset_class": "equity",
  "clusters": [],
  "from": "2026-08-06T15:00:00Z",
  "kind": "asset",
  "previous_total_posts": 17205,
  "results": [
    {
      "asset_class": "equity",
      "asset_id": "NVDA",
      "bearish_posts": 61,
      "bullish_posts": 214,
      "kind": "asset",
      "name": "NVIDIA Corporation",
      "neutral_posts": 111,
      "posts": 386,
      "previous_posts": 273,
      "price_change_24h_pct": -2.48,
      "share": 0.025255,
      "share_change": 0.009388,
      "share_change_pct": 59.16,
      "symbol": "NVDA"
    },
    {
      "asset_class": "equity",
      "asset_id": "AMZN",
      "bearish_posts": 30,
      "bullish_posts": 92,
      "kind": "asset",
      "name": "Amazon.com, Inc.",
      "neutral_posts": 63,
      "posts": 185,
      "previous_posts": 165,
      "price_change_24h_pct": -0.32,
      "share": 0.012104,
      "share_change": 0.002516,
      "share_change_pct": 26.24,
      "symbol": "AMZN"
    }
  ],
  "to": "2026-08-07T15:00:00Z",
  "total_posts": 15284
}