すべてのドキュメント Nebula ドキュメント すべてのエンドポイント インタラクティブドキュメント Markdown OpenAPI JSON
  1. REST API
  2. 市場センチメント

コール結果の分布

GET /calls/returns
GetCallReturns

最近のコールがどのような成績だったか。勝率、リターンの中央値と平均、およびリターンの分布です。各コールは、その後の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 支払いガイド。

パラメータ

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

resolved_days integer QUERY

解決済みコールを何日分含めるか。24時間の判定時点がこの日数以内に過ぎたコールが対象です。無料プランは90日まで遡れます。それより前を指定すると403を返します。

Default:7

clusters array<string> QUERY

読み取る投稿者クラスター。繰り返し指定して組み合わせられます（例: clusters=kols&clusters=media）。選択したクラスターは合算され、1 人の投稿者が複数のクラスターに属することもあります。

  • Callers: smart_money（成績の良い Caller）、dumb_money（成績の悪い Caller）、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'

レスポンス

200 OK
400 不正なリクエスト
401 未認証
402 クレジットを使い切りました。レスポンスには更新時期と購入済みクレジット残高が含まれます
403 アクセス拒否
404 見つかりません
405 メソッドが許可されていません。Allow ヘッダーにサポートされているメソッドが記載されています。
429 リクエストが多すぎます
500 内部サーバーエラー
503 サービス利用不可

メディアタイプ application/json

average_return_pct
number (double) 必須

解決済みコール全体における方向一致リターンの平均（パーセンテージポイント）。

buckets
array<object> 必須

リターン分布のバケット（昇順）。
buckets[].call_count
integer (int64) 必須

このリターンバケット内の解決済みコール数。

buckets[].capped_total_aligned_return_pct
number (double) 必須

方向一致リターンの合計。各コールは±100%で上限処理され、単位はパーセンテージポイントです。

buckets[].label
string 必須

人間が読める形式のバケットまたはインデックスのラベル。

buckets[].lower_bound_pct
number (double) 必須

リターン下限（両端を含む）。単位はパーセンテージポイントで、最初の上限なしバケットではnullです。

buckets[].total_aligned_return_pct
number (double) 必須

このバケットにおける方向一致リターンの合計。単位はパーセンテージポイントです。

buckets[].upper_bound_pct
number (double) 必須

リターン上限（両端を含まない）。単位はパーセンテージポイントで、最後の上限なしバケットではnullです。

losses
integer (int64) 必須

方向一致リターンが負となった確定済みコール。

median_return_pct
number (double) 必須

確定済みコール全体における方向一致リターンの中央値。単位はパーセンテージポイントです。

resolved_calls
integer (int64) 必須

結果が確定したコールの数。

resolved_days
integer 必須

統計に含まれる確定済みコールの日数。

win_rate_pct
number (double) 必須

確定済みコールのうち勝ちとなった割合（0〜100のパーセンテージ）。

wins
integer (int64) 必須

方向一致リターンが正となった確定済みコール。

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