喊单结果分布
/calls/returns
近期喊单的表现：胜率、收益率中位数和平均值，以及收益率分布。每条喊单按其发出后 24 小时内的价格变动、从喊单者一侧计分，因此对下跌 10% 的空头喊单记为 +10%。发送 clusters 可比较不同群体，例如将 smart_money 与 dumb_money 对比。
参数规则：
- 同时发送
asset_class和asset_id，或两者都不发送。
钱包支付可通过 https://nebula-api.hiddensystems.ai/api/v1/x402/calls/returns 使用。无需 Nebula 账户或 API key；签名前请先查看支付报价。x402 支付指南。
参数
来自 /assets 或 /search 的资产 ID，例如 NVDA、GLD、SPX 或 bitcoin。请与随其一同返回的 asset_class 一起发送。
Example:NVDA
asset_id 所指资产的类别：equity（股票和 ETF）、commodity、index 或 crypto。请发送 /assets 或 /search 随 asset_id 一同返回的 asset_class。
equitycommodityindexcrypto
Example:equity
纳入多少天内已结算的喊单：即 24 小时标记落在这么多天以内的喊单。免费方案可回溯 90 天；更早则返回 403。
Default:7
要读取的作者集群；重复传入可组合，例如 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 --request GET \
--url 'https://nebula-api.hiddensystems.ai/api/v1/public/calls/returns' \
--header 'X-API-Key: YOUR_API_KEY'响应
媒体类型 application/json
average_return_pct
已结算喊单中方向对齐收益率的平均值，以百分点计。
buckets
array<object>
按升序排列的收益率分布区间。
buckets
按升序排列的收益率分布区间。
buckets[].call_count
该收益率区间内已结算的喊单数。
buckets[].capped_total_aligned_return_pct
方向对齐收益之和，每次调用上限为 ±100%，单位为百分点。
buckets[].label
人类可读的桶标签或指数标签。
buckets[].lower_bound_pct
收益下界（含），单位为百分点；对于第一个开放式分桶为 null。
buckets[].total_aligned_return_pct
该分桶内方向对齐收益之和，单位为百分点。
buckets[].upper_bound_pct
收益上界（不含），单位为百分点；对于最后一个开放式分桶为 null。
losses
方向对齐收益为负的已结算调用数。
median_return_pct
所有已结算调用的方向对齐收益中位数，单位为百分点。
resolved_calls
已结算结果的调用数。
resolved_days
统计所涵盖的已结算调用天数。
win_rate_pct
获胜的已结算调用占比，取值 0 到 100。
wins
方向对齐收益为正的已结算调用数。
{
"average_return_pct": 4.1,
"buckets": [
{
"call_count": 91,
"capped_total_aligned_return_pct": -228,
"label": "-10% to 0%",
"lower_bound_pct": -10,
"total_aligned_return_pct": -342.5,
"upper_bound_pct": 0
}
],
"losses": 174,
"median_return_pct": 2.8,
"resolved_calls": 412,
"resolved_days": 7,
"win_rate_pct": 57.77,
"wins": 238
}