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
關注度預測
某資產的討論熱度在接下來 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 為 Extreme Fear、40 為 Fear、60 為 Neutral、80 為 Greed，高於 80 為 Extreme Greed。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
叢集熱潮週期
某個 cluster 相較於市場，在 hype cycle 中提早抵達的程度。curve 是各陣營在高峰前 7 天到高峰後 7 天的貼文累計占比，因此線愈靠左代表愈早；lead_days 是該 cluster 的領先幅度（正值代表較早），clusters 則將所有 cluster 的領先幅度排名。
/clusters/overlap
叢集重疊
哪些 cluster 關注與此 cluster 相同的資產，以及它們的看法是否一致。overlap_share 是某個同儕與其前 50 大資產的重疊比例；direction_agreement_share 是它們看法一致的頻率；stance_gap 為正值時，代表此 cluster 較看多。
/clusters/profile
叢集概況
單一 cluster 的行為特徵，每項皆與其他所有 cluster 相比排名（rank 1 為最高）：
/clusters/rotation
叢集輪動
某個叢集的關注焦點正在如何移動：相較於前一個視窗，在其貼文中占比上升與下降的資產（以基點計），以及其貼文如何在市場、人物與事件之間分布。
/clusters/stances
叢集立場
某個叢集對其最熱門討論資產的立場，並與市場的立場並列，從 −1（全看空）到 +1（全看多）。contrarian_share 是它與市場立場相反的程度，並附上其他叢集的平均值以供比較。