多空喊單

GET /calls

GetCalls

人們針對某項資產、或橫跨所有市場，隨時間做出的多空喊單數量。喊單是指宣稱某資產將上漲或下跌、揭露自身持倉，或叫他人進場；單純的意見不算。傳送 clusters 可計入某一群組的喊單。

參數規則：

可使用錢包於 https://nebula-api.hiddensystems.ai/api/v1/x402/calls 付款。不需要 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

hours integer QUERY

回溯期間，以小時為單位。免費方案可回溯 90 天；更早的期間會回傳 403。

Default:720

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 --request GET \
  --url 'https://nebula-api.hiddensystems.ai/api/v1/public/calls' \
  --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[].long_calls

integer (int64) 必填

該分桶中的做多喊單數。

series[].short_calls

integer (int64) 必填

該分桶中的做空喊單數。

series[].timestamp

string 必填

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

{
  "series": [
    {
      "long_calls": 184,
      "short_calls": 71,
      "timestamp": "2026-08-07T15:00:00Z"
    }
  ]
}