多空喊单

GET /calls

GetCalls

人们在一段时间内对某项资产或整个市场做出的多头和空头喊单数量。喊单是指声称某资产将上涨或下跌、披露持仓，或告诉他人建仓；单纯的观点不算。发送 clusters 可统计某一群体的喊单。

参数规则：

钱包支付可通过 https://nebula-api.hiddensystems.ai/api/v1/x402/calls 使用。无需 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

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 Credits 已用尽；响应中包含续期时间和已购买的 credit 余额

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"
    }
  ]
}