心智占有率

GET /mindshare
GetMindshare

某項資產或主體在對話中的占比:其過去 24 小時的貼文數占其市場(股票、加密貨幣,或人物與主題)所有貼文的比例,介於 0 到 1。傳送 clusters 可衡量一個或多個作者群組內的占比。

參數規則:

  • 傳送 asset_id 或 subject_id。
  • asset_id 必須與 asset_class 一起傳送。
  • subject_id 不能與 asset_id 或 asset_class 合併使用。

可使用錢包於 https://nebula-api.hiddensystems.ai/api/v1/x402/mindshare 付款。不需要 Nebula 帳號或 API 金鑰;簽署前請先確認付款條件。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:720

granularity string QUERY

要求的時間序列分桶大小。省略時,服務會依回看區間選擇合適的分桶大小。

允許的值
1h2h4h12h1d

Example:1h

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

Example:smart_money

cURL 範例

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

回應

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

媒體類型 application/json

series
array<object> 必填

依時間順序排列的觀測值。

series[].share
number (double) 必填

符合資格的社群關注度占比,以 0 到 1 的小數表示。

series[].timestamp
string (date-time) 必填

觀測值或分桶開始時間的 UTC RFC 3339 時間戳記。

{
  "series": [
    {
      "share": 0.148,
      "timestamp": "2026-08-07T15:00:00Z"
    }
  ]
}