喊單結果分布
/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 金鑰；簽署前請先確認付款條件。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
}